カスタム指標の使用

このガイドでは、カスタム指標を作成して使用する方法について説明します。情報は次のセクションに分かれています。

  • OpenCensus によるカスタム指標: オープンソースのモニタリングとトレースのライブラリである OpenCensus を使用して、カスタム指標を作成し、それらに指標データを追加し、Stackdriver Monitoring にエクスポートする方法について説明します。

    OpenCensus から Stackdriver Monitoring に指標がエクスポートされると、Monitoring ではそれらを他のカスタム指標と同様に扱います。

  • カスタム指標の作成: Stackdriver Monitoring API を使用してカスタム指標を作成し、それらに時系列データを追加する方法について説明します。

    Monitoring API については、API Explorer と C#、Go、Java、Node.js、PHP、Python、Ruby の各プログラミング言語を使用した例が示されています。

以下の情報は、カスタム指標と、Stackdriver Monitoring によって提供される指標の両方に適用されます。

  • 指標の閲覧: カスタム指標と 900 以上の組み込み指標を一覧表示し、それらの指標を調べる方法について説明します。
  • 指標の読み取り: Monitoring API を使用してカスタム指標や組み込み指標から時系列データを取得する方法について説明します。グラフやアラートで指標データを使用することもできます。

指標に対するこうした操作のすべてには Stackdriver Monitoring API v3 が必要です。リファレンス ドキュメントとしては、Stackdriver Monitoring API の概要をご覧ください。

Stackdriver Monitoring の基礎となる指標の概念についての説明は、指標、時系列、リソースをご覧ください。

始める前に

カスタム指標は Stackdriver Monitoring の課金対象機能のため、カスタム指標の利用には料金が発生する場合があります。価格設定の詳細については、Stackdriver の料金をご覧ください。

カスタム指標は、ワークスペースのメンバーである Google Cloud Platform プロジェクトに属します。組み込み指標を閲覧するだけの場合でも、作業用のプロジェクトが必要です。

  1. アクセスしたいモニタリング データがある Google Cloud Platform Console プロジェクトを作成または選択します。このガイドでは、プロジェクトのための ID は、{your-project-id} と表記しています。
  2. Monitoring 用のプロジェクトを有効にします

GCP プロジェクトの Stackdriver ログに基づいて指標を設定する場合は、ログベースの指標を使用します。

カスタム指標の概要

カスタム指標は Monitoring の組み込み指標とほぼ同じですが、次の点が異なります。

  • カスタム指標は GCP プロジェクト内に作成できます。
  • 通常、カスタム指標名は custom.googleapis.com/ で始まります。これは組み込み指標とは異なります。
  • カスタム指標に時系列データを書き込むことができます。
  • カスタム指標を削除できます。

組み込み指標の詳細については、指標の一覧をご覧ください。

次の表は、Monitoring API のどのメソッドがカスタム指標と組み込み指標で使用できるかを示しています。

Monitoring API の API メソッド カスタム指標で
使用
組込み指標で
使用
monitoredResourceDescriptors.get
monitoredResourceDescriptors.list
metricDescriptors.get
metricDescriptors.list
timeSeries.list
timeSeries.create
metricDescriptors.create
metricDescriptors.delete

制限とレイテンシ

カスタム指標の数とアクティブな時系列の数に対する制限、およびデータの保持期間については、割り当てと制限をご覧ください。保存期間を超えて指標データを保持する場合は、Cloud Storage や BigQuery のような別の場所にデータを手動でコピーする必要があります。

カスタム指標へのデータの書き込みに伴うレイテンシについて詳しくは、指標データのレイテンシをご覧ください。

このページは役立ちましたか?評価をお願いいたします。

フィードバックを送信...

ご不明な点がありましたら、Google のサポートページをご覧ください。