Cloud Monitoring API の概要

このページでは、Cloud Monitoring API v3 の機能の一部について説明します。

API リファレンス ドキュメントについては、次のいずれかのページをご覧ください。

Monitoring API のプロジェクト名

Monitoring API のすべてのメソッドは、必要な name パラメータを持っています。通常、このパラメータの説明は次のようになります。

必須です。リクエストを実行するプロジェクトです。形式:
projects/[PROJECT_ID_OR_NUMBER]

Monitoring API では、PROJECT_ID_OR_NUMBER の値は次のいずれかを識別します。

Monitoring API の一部のメソッドでは、プロジェクトが指標スコープのスコーピング プロジェクトであることが必要です。他のメソッドではその必要がありません。一部のメソッドでは、プロジェクトのタイプに応じて、異なる結果を返すことがあります。

これらのメソッドのクラスを説明するために、ここでは Monitoring API の以下のリソースを参照する用語であるメトリクス API を使用します。

必要な指標スコープのスコーピング プロジェクト

メトリクス API に含まれていないすべての Monitoring API メソッドには、指標スコープのスコーピング プロジェクトを参照するための name パラメータが必要です。

指標スコープのスコーピング プロジェクトは不要

メトリクス API のいずれのメソッドも、指標スコープのスコーピング プロジェクトを参照するための name パラメータを必要としませんが、一部のメソッドは次の場合に異なる動作をします。

  • メトリクス API の次のメソッドは、指定されたGoogle Cloud プロジェクトで動作します。これらのメソッドは、プロジェクトが指標スコープのスコーピング プロジェクトであるかどうかにかかわらず、指定されたプロジェクト内のデータにのみ影響します。

    • timeSeries.create
    • metricDescriptors.create
    • metricDescriptors.delete
    • metricDescriptors.get
    • monitoredResourceDescriptors.get

  • メトリクス API の残りのメソッドは次のように動作します。

    • 指定されたプロジェクトが指標スコープのスコープピング プロジェクトでない場合、このメソッドは指定されたプロジェクトからのデータのみ取得します。
    • 指定されたプロジェクトが、指標スコープのスコープピング プロジェクトである場合、このメソッドは指定したプロジェクトとそのモニタリング対象プロジェクトの両方からデータを取得します。

    このグループのメソッドは次のとおりです。

    • timeSeries.list
    • timeSeries.query
    • metricDescriptors.list
    • monitoredResourceDescriptors.list

指標スコープのスコーピング プロジェクトとして Google Cloud プロジェクトを設定する方法については、指標スコープの概要をご覧ください。

API リソース

指標

Monitoring API を使用すると、Google Cloud とアマゾン ウェブ サービス（AWS）からおおよそ 6,500 の Cloud Monitoring メトリクスにアクセスできます。独自のカスタム指標を作成することや、グループを使用してクラウド リソースを整理することができます。

指標のコンセプトとそれらを表すデータ構造の概要については、指標、時系列、リソースを参照してください。

カスタム指標や組込み指標を管理する方法については、ユーザー定義の指標の概要を参照してください。

使用可能な指標の詳細リストについては、指標の一覧を参照してください。

モニタリング対象リソース

モニタリング対象リソースは、指標が収集される対象です。たとえば、VM インスタンスやハードウェアの一部のアクティビティなどがあります。

使用可能なモニタリング対象リソースの一覧については、モニタリング対象リソースの一覧をご覧ください。

モニタリング対象リソースのグループ

グループは、モニタリング対象リソースの動的コレクションです。いつも Google Cloud コンソールでグループを手動で作成できていました。また、Cloud Monitoring API で、グループを作成して使用するコードを記述することもできます。

詳しくは、Group の API リファレンスをご覧ください。

アラート ポリシー

アラート ポリシーは、インシデントを生成するための条件と、インシデントが作成されたときに通知する方法を記述する構成リソースです。アラートの概要では、アラート ポリシーの基本コンセプトについて説明します。詳しくは、AlertPolicy の API リファレンスをご覧ください。

この API では、2 つのメトリクスの比率に基づいてアラート ポリシーを作成することもできます。現時点では、 Google Cloud コンソールで Monitoring を使用して比率を作成することはできません。詳細については、AlertPolicy リファレンスの MetricThreshold をご覧ください。

通知チャンネル

通知チャンネルは、インシデントが発生したときに通知する方法を記述する構成リソースです。通知チャンネルは、さまざまな種類の通信サービスとエンドポイントを参照できます。これらは記述子で指定します。記述子によって、チャンネル オブジェクトに含まれる構成パラメータのセットが決まります。

詳細については、NotificationChannel リファレンスと NotificationChannelDescriptor リファレンスをご覧ください。

サービスのモニタリング

サービスのモニタリング リソースを使用して、サービスの状態のモニタリングに使用できるサービスレベルの目標を設定します。

Service Monitoring は、Monitoring API に次のリソースを追加します。

これらのサービス モニタリングのコンセプトと API の使用方法について詳しくは、SLO のモニタリングをご覧ください。

ダッシュボード

Dashboards エンドポイントを使用して、ダッシュボードとグラフの両方をプログラムで作成して操作できます。このエンドポイントを使用してダッシュボードとグラフを管理する方法については、API によるダッシュボードの管理をご覧ください。

Monitoring Query Language

Monitoring Query Language（MQL）では、Cloud Monitoring 時系列データをクエリするためのテキストベースのインターフェースが提供されています。MQL はパイプクエリ モデルを使用しており、Monitoring フィルタよりも表現力があります。MQL クエリは Monitoring API またはコードエディタから使用できます。

MQL の一般的な情報については、Monitoring Query Language の使用をご覧ください。

Monitoring API で、MQL を使用して時系列データを取得する方法については、timeSeries.query メソッドの API リファレンスをご覧ください。

フィルタ

Monitoring API は、フィルタを使用して、指標の選択、時系列データの取得、モニタリング対象リソースのグループへの収集を行います。詳細については、モニタリング フィルタをご覧ください。

Monitoring API では、フィルタを使用して特定の list オペレーションの結果のセットを制限することも行います。alertPolicies.list メソッドと notificationChannels.list メソッドの結果の管理の詳細については、並べ替えとフィルタリングをご覧ください。

次のステップ