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

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

始める前に

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

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

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

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

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

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

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

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

Ops エージェントの要件

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

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

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

Google Cloud CLI または REST API を使用して、installOpsAgent フィールドを含むジョブを作成し、JSON ファイルの本文の allocationPolicy.instances フィールドにおいて、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 エージェントの指標を確認できます。詳細については、指標を表示してジョブリソースをモニタリングして最適化するをご覧ください。

次のステップ