Oracle Cloud Infrastructureドキュメント

DevOpsメトリック

メトリックによって、クラウド・リソースをアクティブかつパッシブにモニターできます。

メトリックを使用してリソースのパフォーマンスをモニターできます。このトピックでは、次のメトリック・ネームスペースによって生成されるメトリックについて説明します:

  • oci_devops_code_repos (コード・リポジトリ)
  • oci_devops_build (ビルド)
  • oci_devops_deployment (デプロイメント)
DevOpsメトリックは、次のトラッキングに役立ちます:
  • 各ビルド実行にかかった時間。
  • ビルドが成功および失敗した回数。
  • 各デプロイメントにかかった時間。
  • デプロイメントが失敗した回数。
  • コード・リポジトリの数。
  • コード・リポジトリに対して実行されたプッシュおよびプルの数。
  • コード・リポジトリの合計サイズ。
モニター対象リソース:
  • ビルド・パイプライン
  • ビルド実行
  • デプロイメント・パイプライン
  • デプロイメント
  • コード・リポジトリ

前提条件

リソースをモニターするには、管理者が記述したIAMポリシーで必要なタイプのアクセス権が付与されている必要があります。コンソール、REST API、またはSDKとCLIを使用するには、ポリシーが必要です。ポリシーでは、モニタリング・サービスおよびモニター対象リソースへのアクセス権が付与されている必要があります。アクションを実行しようとすると、権限がないか認可されていないというメッセージが表示されることがあります。付与されているアクセス権のタイプおよび作業する必要のあるコンパートメントを管理者に確認してください。モニタリングのためのユーザー認可の詳細は、モニタリングの概要の認証と認可の項を参照してください。

このページにリストされているメトリックは、作成したDevOpsインスタンスで自動的に使用可能になります。これらのメトリックを取得するためにリソースのモニタリングを有効にする必要はありません。

使用可能なメトリック

DevOpsメトリックには、次のディメンションが含まれます:

  • projectId: プロジェクト識別子
  • projectName: DevOpsプロジェクトの名前
  • buildPipelineId: ビルド・パイプライン識別子
  • stageId: ビルド・ステージ識別子
  • lifecycleState: ビルド・パイプラインの現在の状態
  • stageType: ビルド・ステージのタイプ
  • repositoryType: ミラー化または非ミラー化(ホスト)
  • repositoryId: コード・リポジトリ識別子
  • repositoryName: コード・リポジトリ名
  • pushType: HTTPまたはSSH
  • pullType: HTTPまたはSSH
  • deployPipelineId: パイプライン識別子
  • displayName: パイプラインの名前
  • deployStageId: ステージ識別子
  • deployStageName: ステージ名
メトリック 表示名 単位 説明 ディメンション
BuildSuccess 成功したビルド実行 件数 ビルド実行が成功した回数。
  • projectId
  • buildPipelineId
BuildFailure ビルド実行の失敗 件数 ビルド実行が失敗した回数。
  • projectId
  • buildPipelineId
BuildRunExecutionTime ビルド実行期間 秒 ビルドにかかった時間。
  • projectId
  • buildPipelineId
  • lifecycleState
StageExecutionTime ステージ実行時間 秒 ステージにかかった時間。
  • projectId
  • buildPipelineId
  • stageId
  • stageType
CodeRepositories コード・リポジトリ数 件数 コード・リポジトリの数。
  • repositoryType
  • projectId
  • projectName
CodeRepositoriesPushes コード・リポジトリのプッシュ 件数 コード・リポジトリで行われたプッシュの数。
  • repositoryId
  • pushType
  • repositoryName
  • projectName
CodeRepositoriesPulls コード・リポジトリのプル 件数 コード・リポジトリで行われたプルの数。
  • repositoryId
  • pullType
  • repositoryName
  • projectName
CodeRepositorySize コード・リポジトリのサイズ MB コード・リポジトリの合計サイズ。
  • repositoryId
  • repositoryName
  • projectName
TimeInAcceptedState 受入れ済状態での時間 ミリ秒 デプロイメントが受入れ済状態であった時間。
  • deployPipelineId
  • displayName
DeploymentExecutionTime デプロイメント実行時間 ミリ秒 デプロイメントにかかった合計時間。
  • deployPipelineId
  • displayName
StageTimeOut ステージのタイムアウト回数 タイムアウト ステージがタイムアウトした回数。
  • deployPipelineId
  • deployStageId
  • displayName
  • deployStageName
DeploymentFailure デプロイメントの失敗数 1または0
  • 1: デプロイメント失敗。
  • 0: デプロイメント成功。
 デプロイメントが失敗した回数。
  • deployPipelineId
  • displayName

コンソールの使用

次に、メトリック・チャートを表示する方法を示します:

  1. コンソールで、ナビゲーション・メニューを開きます。「監視および管理」で、「モニタリング」に移動して「サービス・メトリック」をクリックします。
  2. パフォーマンスを監視するDevOpsコード・リポジトリ、パイプラインおよびデプロイメントを含むコンパートメントを選択します。
  3. 「メトリック・ネームスペース」で、oci_devops_build、oci_devops_deploymentまたはoci_devops_code_reposを選択します。

「サービス・メトリック」ページが動的に更新され、選択したメトリック・ネームスペースによって生成された各メトリックのチャートが表示されます。

APIの使用

メトリックをモニターするには、モニタリングAPIを使用します。

APIの使用およびリクエストの署名の詳細は、REST APIおよびセキュリティ資格証明を参照してください。