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

Cloud Logging でログを確認する

このページでは、統合の Cloud Logging を有効にする方法、Cloud Logging でログを表示する方法、および Cloud Logging で統合ログを表示するためのサンプルクエリについて説明します。

概要

Cloud Logging では、ステータス、パフォーマンス、統合バージョン、リクエストとレスポンスのパラメータ、トリガーとタスクの構成など、統合の詳細を含む統合実行ログを表示できます。Cloud Logging の実行ログの詳細については、Cloud Logging の統合実行ログをご覧ください。制限事項と料金については、制限事項と料金をご覧ください。

デフォルトでは、Cloud Logging は統合に対して無効になっています。統合の非公開バージョンを編集することで、統合のロギングを有効にすることができます。

Cloud Logging を有効にする

統合実行ログを Cloud Logging に保存するには、まず統合に対して Cloud Logging を有効にする必要があります。方法は次のとおりです。

  1. Google Cloud コンソールで [Application Integration] ページに移動します。

    Application Integration に移動

  2. ナビゲーション メニューで [統合] をクリックします。

    [統合] ページが開き、Google Cloud プロジェクトで使用可能なすべての統合が一覧表示されます。

  3. Cloud Logging を有効にする既存の統合を選択するか、新しい統合を作成します。

    統合エディタで統合が開きます。

  4. 統合の DRAFT バージョンを選択します。下書きモード以外のバージョンの設定は、そのバージョンが公開されているか非公開であるかを問わず、変更できません。統合バージョンのリストについては、バージョンをご覧ください。
  5. デザイナー ツールバーの （[統合の概要]）をクリックします。[統合の概要] ページが表示されます。
    1. [ログ設定] で [Cloud Logging を有効にする] 切り替えボタンをクリックして、[重大度] リストから、Cloud Logging に保存するログの重大度タイプを選択します。
      • 情報: すべての実行ステータス（SUCCEEDED、FAILED、PROCESSING、PENDING、SUSPENDED、RETRY_ON_HOLD、CANCELLED）をキャプチャするには、このオプションを選択します。
      • エラー: 次の実行ステータス（FAILED、CANCELLED）をキャプチャするには、このオプションを選択します。
      • 警告: 次の実行ステータス（FAILED、CANCELLED）をキャプチャするには、このオプションを選択します。

        • 統合の実行状態の一覧については、実行の状態をご覧ください。

    2. [保存] をクリックします。

ログを表示

Cloud Logging でログを表示するには、まず Cloud Logging を有効にしてから、次の手順を行います。

  1. Google Cloud コンソールで [Application Integration] ページに移動します。

    Application Integration に移動

  2. Cloud Logging で統合実行ログを表示するには、次のいずれかの方法を使用します。
    • ナビゲーション メニューで [ログ] をクリックし、[Cloud ログを表示] をクリックします。
    • 統合エディタで、統合をテストした後、[テスト統合] ペインで [Cloud ログを表示] をクリックします。

    [ログ エクスプローラ] ページが表示されます。次のデフォルト クエリの過去 3 時間のログが表示されます。 

    resource.type=integrations.googleapis.com/IntegrationVersion

    3. Application Integration ログのログ形式については、log_entries ペイロードをご覧ください。

サンプルクエリ

次のクエリを使用して、Cloud Logging でログを表示できます。

  • すべての統合実行ログを表示するには:

        resource.type="integrations.googleapis.com/IntegrationVersion"

  • 特定の実行 ID の統合実行ログを表示できます。

    • 指定された実行 ID を持つ親実行のみを検索します。 
          resource.type="integrations.googleapis.com/IntegrationVersion"
    jsonPayload.executionId="EXECUTION_ID"
    • 指定された実行 ID から起動された親実行と子実行の両方を検索します。 
          resource.type="integrations.googleapis.com/IntegrationVersion"
    "EXECUTION_ID"

  • 特定の統合の統合実行ログを表示するには:

        resource.type="integrations.googleapis.com/IntegrationVersion" 
    "INTEGRATION_NAME"
    　または　 
        resource.type="integrations.googleapis.com/IntegrationVersion"
    jsonPayload.integration="INTEGRATION_NAME"

  • 特定の統合の失敗した統合実行を表示するには:

        resource.type="integrations.googleapis.com/IntegrationVersion"
    jsonPayload.integrationExecutionDetails.integrationExecutionState="FAILED"
    jsonPayload.integration="INTEGRATION_NAME"

  • 特定のリクエスト パラメータ名のログを表示するには。たとえば、次のクエリでは requestUrl パラメータのログをリクエストします。

        resource.type="integrations.googleapis.com/IntegrationVersion"
    "requestUrl"

    • その他のサンプルクエリについては、Cloud Logging のサンプルクエリをご覧ください。

制限事項

Cloud Logging の統合ログには、次の制限があります。

  • Cloud Logging では、最大 256 KiB までのログエントリのみがサポートされます。ログがこの上限を超えている場合、リクエスト パラメータとレスポンス パラメータはロギングの詳細に表示されません。Cloud Logging の割り当てと上限については、割り当てと上限をご覧ください。このエラーを解決するには、値が上限を超えないように統合変数を更新します。または、Application Integration でこれらのログを表示することもできます。
  • ローカル ロギングが無効になっている場合、Cloud Logging が有効になっても、実行ログは Cloud Logging に送信されません。

料金

Cloud Logging の料金については、Cloud Logging の料金をご覧ください。

次のステップ