Metrics enable you to monitor your cloud resources actively and passively.
You can monitor the performance of your resources by using metrics. This topic describes the metrics emitted by the following metric namespaces:
- Time spent for each build run.
- Number of times builds have succeeded and failed.
- Time spent for each deployment.
- Number of times a deployment has failed.
- Number of code repositories.
- Number of pushes and pulls done on code repositories.
- Total size of the code repository.
- Build pipelines
- Build runs
- Deployment pipelines
- Code repositories
To monitor resources, you must be given the required type of access in an IAM policy written by an administrator. Policies are required for using the Console, REST API, or SDK and CLI. The policy must give you access to the monitoring services and the resources being monitored. When you try to perform an action, you might get a message that you don’t have permission or are unauthorized. Confirm with your administrator the type of access that you have been granted and which compartment you must work in. For more information about user authorizations for monitoring, see the Authentication and Authorization section in Overview of Monitoring.
The metrics listed on this page are automatically available for any DevOps instances that you create. You don't need to enable monitoring on the resource to get these metrics.
DevOps metrics include the following dimensions:
projectId: Project identifier
projectName: Name of the DevOps project
buildPipelineId: Build pipeline identifier
stageId: Build stage identifier
lifecycleState: Current state of the build pipeline
stageType: Type of build stage
repositoryType: Mirrored or Non mirrored (hosted)
repositoryId: Code repository identifier
repositoryName: Code repository name
pushType: HTTP or SSH
pullType: HTTP or SSH
deployPipelineId: Pipeline identifier
displayName: Name of the pipeline
deployStageId: Stage identifier
deployStageName: Stage name
||Successful Build Runs||Count||Number of times build runs have succeeded.||
||Build Run Failures||Count||Number of times build runs have failed.||
||Build Run Duration||Seconds||Amount of time taken by builds.||
||Stage Run Time||Seconds||Amount of time taken by stages.||
||Code Repositories Count||Count||Number of code repositories.||
||Code Repositories Pushes||Count||Number of pushes done on code repositories.||
||Code Repositories Pulls||Count||Number of pulls done on code repositories.||
||Code Repositories Size||Megabytes||Total size of the code repository.||
||Time In Accepted State||Milliseconds||Amount of time the deployment was in an accepted state.||
||Deployment Execution Time||Milliseconds||Total amount of time the deployment took.||
||Stage Timeout||Timeouts||Number of times a stage timed out.||
||Deployment Failures||1 or 0
||Number of times a deployment failed.||
Using the Console
Here's how you view the metric charts:
- In the Console, open the navigation menu. Under Observability & Management, go to Monitoring and click Service Metrics.
- Select the compartment that contains the DevOps code repositories, pipelines, and deployments whose performance you want to monitor.
- For Metric namespace, select
The Service Metrics page dynamically updates the page to show charts for each metric that the selected metric namespace emits.
Using the API
To monitor the metrics, use the Monitoring API .