Application Integration でサポートされているコネクタをご覧ください。

Application Integration リソースをモニタリングする

このページでは、Google Cloud プロジェクトで Application Integration リソースの使用状況とパフォーマンスをモニタリングする方法について説明します。

Application Integration では、Cloud Monitoring を活用して、統合リソースの使用状況、パフォーマンス、アラート、全体的な健全性を可視化します。Cloud Monitoring を使用すると、カスタムグラフやダッシュボードを作成し、統合のさまざまなパフォーマンス指標とリソースの使用状況を可視化できます。Cloud Monitoring では、これらの指標のアラートとアラート ポリシーを構成することもできます。たとえば、グラフを作成して、特定の期間に処理されたデータの量を表示およびモニタリングできます。さらに、処理されたデータの合計が指定したしきい値を超えたかどうかを確認するアラートを設定することもできます。アラートの構成方法については、アラートをご覧ください。

次の方法で、すべての統合指標とリソースの使用状況にアクセスしてモニタリングできます。

使用可能な指標とラベル

リソースの指標

次の表の指標タイプの文字列には、integrations.googleapis.com/ という接頭辞を付ける必要があります。この接頭辞は表内で省略されています。 ラベルをクエリする場合は、metric.labels. 接頭辞を使用します。例: metric.labels.LABEL="VALUE"。

指標タイプ リリース ステージ （リソース階層レベル）
表示名
種類、タイプ、単位
モニタリング対象リソース		 説明
ラベル
integration/execution_count ベータ版  （プロジェクト）
統合実行回数
DELTA, INT64, 1
integrations.googleapis.com/IntegrationVersion 		最後のサンプル以降の統合実行の数。60 秒ごとにサンプリングされます。サンプリング後、データは最長 86400 秒間表示されません。
status: 統合実行ステータス（SUCCEEDED、FAILED、CANCELLED、RETRY_ON_HOLD）のいずれか。
trigger_name: 統合実行に使用されるトリガーのタイプ（「API トリガー」や「Cloud Pub/Sub トリガー」など）。
trigger_id: 統合の実行をトリガーしたトリガー ID。
error_enum: 統合の実行中に発生した最後のエラーの正規コード（PERMISSION_DENIED、INVALID_ARGUMENT など）。
is_retry: （BOOL） 統合実行が再試行か最初の試行か（[true、false]）を示します。
integration/execution_latencies ベータ版  （プロジェクト）
統合実行のレイテンシ
DELTA, DISTRIBUTION, ms
integrations.googleapis.com/IntegrationVersion 		統合が実行を完了するまでにかかる時間の分布。60 秒ごとにサンプリングされます。サンプリング後、データは最長 86400 秒間表示されません。
status: 統合実行ステータス（SUCCEEDED、FAILED、CANCELLED、RETRY_ON_HOLD）のいずれか。
trigger_name: 統合実行に使用されるトリガーのタイプ（「API トリガー」や「Cloud Pub/Sub トリガー」など）。
trigger_id: 統合の実行をトリガーしたトリガー ID。
error_enum: 統合の実行中に発生した最後のエラーの正規コード（PERMISSION_DENIED、INVALID_ARGUMENT など）。
is_retry: （BOOL） 統合実行が再試行か最初の試行か（[true、false]）を示します。
processed_bytes_count ベータ版  （プロジェクト）
処理されたバイト数
DELTA, INT64, By
integrations.googleapis.com/IntegrationVersion 		最後のサンプル以降の統合実行によって消費されたデータのサイズ。これは、統合への入力パラメータおよび出力パラメータのサイズと、REST タスクおよびコネクタタスクのリクエスト ペイロードおよびレスポンス ペイロードのサイズを考慮して計算されます。60 秒ごとにサンプリングされます。サンプリング後、データは最長 86400 秒間表示されません。
step_type: 統合、またはタスク リクエストとレスポンスのペイロードのパラメータ（トリガー、タスク）のいずれかによってデータが処理されるかどうかを示します。
step_name: リクエストとレスポンスのペイロードの処理に使用されるタスクのタイプ、または統合のパラメータの処理に使用されるトリガーのタイプ。
step_id: リクエストとレスポンスのペイロードの処理に使用されるタスク番号、または統合のパラメータの処理に使用されるトリガー ID。
step/execution_count ベータ版  （プロジェクト）
ステップ実行回数
DELTA, INT64, 1
integrations.googleapis.com/IntegrationVersion 		最後のサンプル以降のステップ（タスクまたはトリガー）実行回数。60 秒ごとにサンプリングされます。サンプリング後、データは最長 86400 秒間表示されません。
status: ステップ実行ステータス（例: 「SUCCEEDED」、「FAILED」）。
step_type: 実行されたステップのタイプ（[トリガー、タスク] のいずれか）。
step_name: 実行されたトリガーまたはタスクのタイプ（「API トリガー」や「データ マッピング タスク」など）。
step_id: 実行するステップの種類に応じて、トリガー ID またはタスク番号を指定します。
error_enum: ステップの実行中に発生した正規コード（「PERMISSION_DENIED」、「INVALID_ARGUMENT」など）。
is_retry: （BOOL） ステップの実行が再試行か最初の試行か（[true、false]）のいずれかを示します。
is_step_external: （BOOL） 実行されたタスクが内部タスクか外部タスクか（「true」のいずれか）（外部タスクやコネクタタスクなど）を示します。「false」- Data Mapper タスクや Inline Scripting タスクなどの内部タスク）。
step/execution_latencies ベータ版  （プロジェクト）
ステップ実行のレイテンシ
DELTA, DISTRIBUTION, ms
integrations.googleapis.com/IntegrationVersion 		ステップ（タスク）が実行を完了するまでにかかる時間の分布。60 秒ごとにサンプリングされます。サンプリング後、データは最長 86400 秒間表示されません。
status: ステップ実行ステータス（例: 「SUCCEEDED」、「FAILED」）。
step_name: 実行されたトリガーまたはタスクのタイプ（「API トリガー」や「データ マッピング タスク」など）。
step_id: 実行するステップの種類に応じて、トリガー ID またはタスク番号を指定します。
error_enum: ステップの実行中に発生した正規コード（「PERMISSION_DENIED」、「INVALID_ARGUMENT」など）。
is_retry: （BOOL） ステップの実行が再試行か最初の試行か（[true、false]）のいずれかを示します。
is_step_external: （BOOL） 実行されたタスクが内部タスクか外部タスクか（「true」のいずれか）（外部タスクやコネクタタスクなど）を示します。「false」- Data Mapper タスクや Inline Scripting タスクなどの内部タスク）。

表の生成日時: 2024-10-24 18:54:10 UTC

ラベル

ラベルは Google Cloud コンソールの Application Integration で使用できます。これらのラベルを使用して、各指標をグループ化またはフィルタリングできます。

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

ラベル 説明
resource_container 統合の Google Cloud プロジェクト ID。
場所 統合のリージョン。
インテグレーション 統合の名前。
version 統合のバージョン ID。

指標タイプのラベル

ラベル 説明
status 統合または統合ステップ（タスクまたはトリガー）の実行ステータス。
trigger_name 統合の実行に使用されるトリガーのタイプ。例: API トリガーまたは Cloud Pub/Sub トリガー。
trigger_id 統合の呼び出しに使用されるトリガーの ID。
step_type 統合ステップ、トリガー、またはタスクのタイプ。
step_name タスクまたはトリガーの名前。たとえば、API トリガーやデータ マッピング タスクなどです。
step_id [トリガー] タイプの場合: 各トリガーの ID。

[タスク] タイプの場合: 各タスクのタスク番号。
error_enum 統合または統合ステップの実行中に発生したエラーの正規コード
is_retry 統合またはタスクの実行が再試行されたかどうかを判断するブール値。
is_step_external トリガーまたはタスクの実行が Application Integration の実行エンジンの内部か外部かを判断するブール値。

たとえば、API 呼び出しは実行エンジンの外部から行われるため、REST エンドポイントの呼び出しタスクは外部です。対照的に、データ マッピング タスクは内部です。

利用可能な Google Cloud 指標の完全なリストについては、Google Cloud 指標をご覧ください。

次のステップ