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

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

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

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

Cloud Monitoring の使用
Application Integration でのモニタリングダッシュボードの使用。

使用可能な指標とラベル

リソースの指標

次の表の指標タイプの文字列には、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-12-05 22:01:39 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 指標をご覧ください。

次のステップ

Cloud Monitoring を使用してモニタリングします。
Application Integration のモニタリングダッシュボードを使用してモニタリングします。