Google Cloud Pub/Sub のモニタリング

補足情報

クライアントサイドのトレースに対応

この技術において、 Instana は以下の言語およびランタイムのクライアントサイドトレースをサポートしています：

セットアップ

Instana の Google Cloud 統合では、サービス・アカウントを使用して、Google Cloud と Instana の間の API 接続を作成します。以下の手順では、サービスアカウントを作成し、 Instana のサービスアカウント認証情報を設定して、ユーザーに代わって API への呼び出しを開始する方法について説明します。

Instana の連携を設定したい Google Cloud プロジェクトの Google Cloud 認証情報ページに移動してください。
「資格情報の作成」 > 「サービス・アカウント」をクリックします。
「サービス・アカウントの作成」 ページで、サービス・アカウントの固有の名前を入力し、 「作成して続行」をクリックします。
役割を選択するか、少なくとも以下の権限を含むカスタム役割を作成します。
- monitoring.timeSeries.list
- pubsub.subscriptions.list
- pubsub.topics.list
- resourcemanager.projects.get
カスタム役割を作成するには、以下のステップを実行します。
1. ナビゲーション・メニューから、 「役割」 > 「役割の作成」をクリックします。
2. 役割のタイトルを入力し、 「権限の追加」をクリックします。
3. 前述の基本的な権限 (役割に必要な権限) を追加し、 「作成」をクリックします。
作成したアカウントをサービス・アカウントのリストから選択します。
「KEYS」 タブを選択し、 「キーの追加」をクリックします。
「 新しいキーを作成」を選択し、キーの種類として「 JSON 」を選択してから、 「作成」 をクリックします。

注：統合を完了するには、認証情報のファイルが保存されている場所を記録しておく必要があります。
資格情報ファイルへのパスを指定して、 configuration.yml ファイルにフィールド credentials_path を追加します。例えば、構成を参照してください。

プロジェクトをモニターするには、以下のサービスを有効にする必要があります。

構成

オンラインで編集する

GCP エージェントの設定ファイルに以下の設定を追加することで、 Google Cloud Pub/Sub のメトリクス取得間隔（秒単位）を設定できます：

com.instana.plugin.gcp.pubsub:
  enabled: true
  poll_rate: 60  # How often Google's monitoring API will be polled
  credentials_path: '/opt/instana/credentials/cred-gcp.json'  # Path to Service Account credentials
  include_tags:
    topic:
    subscription:
  exclude_tags:
    topic:
    subscription:

フィルタリング

オンラインで編集する

複数のタグを定義するには、コンマで区切ります。タグは、「:」文字で区切られたキーと値のペアとして指定する必要があります。構成を容易にするために、ディスカバリーに含めるタグを定義することも、ディスカバリーから除外するタグを定義することもできます。両方のリスト (包含および除外) でタグを定義する場合は、除外リストの優先順位が高くなります。サービスのフィルタリングが不要な場合は、構成を定義しないでください。フィルタリングを有効にするためにすべての値を定義する必要はありません。

トピックおよびサブスクリプションをタグ別にディスカバリーに組み込むには、以下の構成を使用します。

com.instana.plugin.gcp.pubsub:
  include_tags:
    topic: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)
    subscription: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)

トピックおよびサブスクリプションをタグ別にディスカバリーから除外するには、以下の構成を使用します。

com.instana.plugin.gcp.pubsub:
  exclude_tags:
    topic: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)
    subscription: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)

組み込みタグ構成をトピックとサブスクリプションの両方に適用する必要がある場合は、以下の構成を使用します。

com.instana.plugin.gcp.pubsub:
  include_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)

除外タグ構成をトピックとサブスクリプションの両方に適用する必要がある場合は、以下の構成を使用します。

com.instana.plugin.gcp.pubsub:
  exclude_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)

Google Cloud Pub/Sub - メトリック収集

オンラインで編集する

構成データ

オンラインで編集する

プロジェクト名
プロジェクト ID
プロジェクト番号
作成時刻

パフォーマンス・メトリック

オンラインで編集する


メトリック	説明	Reducer/Aligner
メッセージ数	Cloud Pub/Sub によってサブスクライバー・クライアントに送信されたメッセージの累積の数。	REDUCE_SUM/ALIGN_DELTA
メッセージ・サイズ	サブスクリプションの未確認メッセージの合計バイト・サイズ。	REDUCE_SUM/ALIGN_MEAN
最も古いメッセージの経過時間	サブスクリプションの最も古い未確認メッセージの経過時間 (秒)。	REDUCE_MAX/ALIGN_MEAN

すべてのメトリックの粒度は 60 秒です。

Google Cloud Pub/Sub トピック - メトリック収集

オンラインで編集する

構成データ

オンラインで編集する

プロジェクト ID
トピック名

パフォーマンス・メトリック

オンラインで編集する


メトリック	説明	Reducer/Aligner
メッセージ・サイズ	サブスクリプションの未確認メッセージの合計バイト・サイズ。	平均値の削減／デルタ値の調整
最も古い確認済みメッセージの経過時間	トピックに保存されている最も古い確認済みメッセージの経過時間 (秒)。クラウドのリージョン別の内訳になっています。	REDUCE_SUM/ALIGN_MEAN
最も古い未確認メッセージの経過時間	トピックの最も古い未確認メッセージの経過時間 (秒)。クラウドのリージョン別の内訳になっています。	REDUCE_SUM/ALIGN_MEAN
公開操作	結果別にグループ化されたメッセージ公開操作の累積の数。	REDUCE_SUM/ALIGN_DELTA
公開要求	結果別にグループ化された公開要求の累積の数。	REDUCE_SUM/ALIGN_DELTA
操作コスト	操作のコスト (バイト)。	REDUCE_SUM/ALIGN_DELTA

すべてのメトリックの粒度は 60 秒です。

Google Cloud Pub/Sub サブスクリプション - メトリック収集

オンラインで編集する

構成データ

オンラインで編集する

プロジェクト ID
サブスクリプション名
トピック名

パフォーマンス・メトリック

オンラインで編集する


メトリック	説明	Reducer/Aligner
メッセージ・サイズ	サブスクリプションの未確認メッセージの合計バイト・サイズ。	REDUCE_NONE/ALIGN_MEAN
確認済みメッセージ数	確認要求によって確認されたメッセージの累積の数。	REDUCE_SUM/ALIGN_DELTA
未確認メッセージ数	サブスクリプションの未確認メッセージの数。	REDUCE_NONE/ALIGN_MEAN
送達不能メッセージ数	送達不能トピックに公開されたメッセージの累積の数。	REDUCE_SUM/ALIGN_DELTA
送信済みメッセージ数	Cloud Pub/Sub によってサブスクライバー・クライアントに送信されたメッセージの累積の数。	REDUCE_SUM/ALIGN_DELTA
未処理メッセージ数	サブスクリプションのプッシュ・エンドポイントに送信されたが、まだ確認されていないメッセージの数。	REDUCE_NONE/ALIGN_MEAN
最も古い確認済みメッセージの経過時間	サブスクリプションに保存されている最も古い確認済みメッセージの経過時間 (秒)。	REDUCE_NONE/ALIGN_MEAN
最も古い未確認メッセージの経過時間	サブスクリプションの最も古い未確認メッセージの経過時間 (秒)。	REDUCE_NONE/ALIGN_MEAN
メッセージのプル操作	結果別にグループ化されたメッセージのプル操作の累積の数。	REDUCE_SUM/ALIGN_DELTA
メッセージの確認操作	結果別にグループ化されたメッセージの確認操作の累積の数。	REDUCE_SUM/ALIGN_DELTA
プル要求	結果別にグループ化されたプル要求の累積の数。	REDUCE_SUM/ALIGN_DELTA
プッシュ要求	結果別にグループ化されたプッシュ試行の累積の数。	REDUCE_SUM/ALIGN_DELTA
確認要求	結果別にグループ化された確認要求の累積の数。	REDUCE_SUM/ALIGN_DELTA
プッシュ要求の待ち時間	結果別にグループ化されたプッシュ要求の待ち時間の分布 (マイクロ秒)。	平均値の削減／デルタ値の調整
構成の更新の数	各サブスクリプションの構成変更の累積の数。	REDUCE_SUM/ALIGN_DELTA
操作コスト	操作の累積のコスト (バイト)。	REDUCE_SUM/ALIGN_DELTA

すべてのメトリックの粒度は 60 秒です。

正常性シグニチャー

オンラインで編集する

センサーごとに、着信メトリックに対して継続的に評価され、ユーザーへの影響に応じて問題またはインシデントを提起するために使用される正常性シグニチャーのキュレーション済み知識ベースがあります。

組み込みイベントは、エンティティのヘルスシグネチャの異常に基づいて問題やインシデントをトリガーし、カスタムイベントは、任意のエンティティの個々のメトリクスについて定義されたしきい値に基づいて問題やインシデントをトリガーします。

Google Cloud Pub/Subの組み込みイベントについて詳しくは、組み込みイベントのリファレンスを参照してください。