Ops エージェントを使用して追加のリソース指標を収集する

このドキュメントでは、Ops エージェントを自動的にインストールする Batch ジョブを作成して実行する方法について説明します。Ops エージェントをインストールすると、ジョブリソースのパフォーマンスに関する追加の指標が Cloud Monitoring に提供されます。ジョブのリソース パフォーマンス指標の使用方法の詳細については、 指標を表示してジョブリソースをモニタリングして最適化するをご覧ください。

始める前に

  1. Batch を以前に使用したことがない場合は、 Batch を使ってみる を確認し、 プロジェクトとユーザーの前提条件を完了して Batch を有効にします。
  2. プロジェクトで Cloud Monitoring API と Cloud Logging API がまだ有効になっていない場合は、有効にします。

    API を有効にするために必要なロール

    API を有効にするには、serviceusage.services.enable 権限を含む Service Usage 管理者 IAM ロール（roles/serviceusage.serviceUsageAdmin）が必要です。詳しくは、ロールを付与する方法をご覧ください。

    API を有効にする

  3. ジョブの作成に必要な権限を取得するには、次の IAM ロールを付与するよう管理者に依頼してください。

    ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

    必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

  4. ジョブのサービス アカウントにデフォルト構成を使用していない場合は、必要な権限があることを確認してください。

    ジョブのサービス アカウントに Ops エージェントの指標を Monitoring に書き込むために必要な権限があることを確認するには、ジョブのサービス アカウントに次の IAM ロールを付与するよう管理者に依頼してください。

  5. 計画されたジョブ構成が Ops エージェントの要件を満たしていることを確認します。

Ops エージェントの要件

Ops エージェントを使用するジョブを作成して実行するには、ジョブが次の要件をすべて満たしている必要があります。

Ops エージェントの機能と要件の詳細については、 Google Cloud Observability ドキュメントのOps エージェントの概要 をご覧ください。

Ops エージェントを自動的にインストールするジョブを作成する

Google Cloud CLI または REST API を使用して ジョブを作成し、JSON ファイルの本文の allocationPolicy.instances フィールドに installOpsAgent フィールド を含め、true を設定します。

"allocationPolicy": {
  "instances": [
    {
      "installOpsAgent": true
    }
  ]
}

たとえば、Ops エージェントを自動的にインストールするジョブには、次のような JSON 構成ファイルを含めることができます。

{
  "taskGroups": [
    {
      "taskSpec": {
        "runnables": [
          {
            "script": {
              "text": "echo Hello World! This is task $BATCH_TASK_INDEX."
            }
          }
        ]
      },
      "taskCount": 3,
    }
  ],
  "allocationPolicy": {
    "instances": [
      {
        "installOpsAgent": true
      }
    ]
  },
  "logsPolicy": {
      "destination": "CLOUD_LOGGING"
  }
}

ジョブの VM の実行が開始されると、他のリソース指標と同じように Ops エージェントの指標を確認できます。詳細については、 指標を表示してジョブリソースをモニタリングして最適化するをご覧ください。

次のステップ