翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

販売されたログとメトリクス

販売された Amazon CloudWatch メトリクスとログを使用して、エージェントスペースとサービスオペレーションをモニタリングできます。このトピックでは、 AWS DevOps Agent がアカウントに自動的に発行する CloudWatch メトリクスと、任意の送信先に配信するように設定できる販売ログについて説明します。

提供された CloudWatch メトリクス

AWS DevOps エージェントは、アカウントの Amazon CloudWatch にメトリクスを自動的に発行します。これらのメトリクスは、設定なしで使用できます。これらを使用して、使用状況のモニタリング、運用アクティビティの追跡、アラームの作成を行うことができます。

サービスにリンクされたロール

このサービスのアカウントで Amazon CloudWatch メトリクスを公開するために、 AWS DevOps エージェントはサービスにリンクされたロール AWSServiceRoleForAIDevOps サービスにリンクされたロールを自動的に作成します。API を呼び出す IAM ロールに適切なアクセス許可がない場合、リソースの作成は InvalidParameterException で失敗します。

サービスにリンクされたロールを手動で作成する (既存のお客様向け)

次のいずれかを行います。

aws iam create-service-linked-role --aws-service-name aidevops.amazonaws.com

名前空間

すべてのメトリクスは AWS/AIDevOps名前空間の下に発行されます。

ディメンション

すべてのメトリクスには、次のディメンションが含まれます。

メトリクスのリファレンス

CloudWatch コンソールでのメトリクスの表示

前提条件

ログ配信を設定する前に、以下があることを確認してください。

提供されるログ

AWS DevOps Agent は、エージェントスペースとサービス登録が処理するイベントを可視化する販売ログをサポートします。提供されたログは、Amazon CloudWatch Logs インフラストラクチャを使用して、任意の宛先にログを配信します。

販売ログを使用するには、配信先を設定する必要があります。次の送信先がサポートされています。

サポートされているログのタイプ

1 つのログタイプがサポートされています: APPLICATION_LOGS。このログタイプは、サービスが発行するすべての運用イベントを対象としています。

ログイベントタイプ

次の表は、 AWS DevOps Agent がログに記録するイベントをまとめたものです。

アクセス許可

AWS DevOps エージェントは、CloudWatch 販売ログ (V2 アクセス許可) を使用してログを配信します。ログ配信を設定するには、配信を設定する IAM ロールに次のアクセス許可が必要です。

各送信先タイプに必要な完全な IAM ポリシーについては、Amazon CloudWatch Logs ユーザーガイドの以下のトピックを参照してください。

ログ配信の設定 (コンソール)

AWS DevOps Agent は、ログ配信を設定するために AWS マネジメントコンソールに 2 つの場所を提供します。

サービス登録のログ配信を設定するには

エージェントスペースのログ配信を設定するには

ログ配信の設定 (CloudWatch API)

CloudWatch Logs API を使用して、プログラムでログ配信を設定することもできます。動作しているログ配信は、次の 3 つの要素で構成されます。

ステップ 1: 配信ソースを作成する

PutDeliverySource オペレーションを使用して配信ソースを作成します。 AWS DevOps エージェントスペースリソースの ARN を渡し、 をログタイプAPPLICATION_LOGSとして指定します。

次の例では、エージェントスペースの配信ソースを作成します。

{
    "name": "my-agent-space-delivery-source",
    "resourceArn": "arn:aws:aidevops:us-east-1:123456789012:agentspace/my-agent-space-id",
    "logType": "APPLICATION_LOGS"
}

次の例では、 サービスの配信ソースを作成します。

{
    "name": "my-service-delivery-source",
    "resourceArn": "arn:aws:aidevops:us-east-1:123456789012:service",
    "logType": "APPLICATION_LOGS"
}

ステップ 2: 配信先を作成する

PutDeliveryDestination オペレーションを使用して、ログの保存先を設定します。Amazon CloudWatch Logs、Amazon S3、または Amazon Data Firehose を選択できます。

次の例では、CloudWatch Logs の送信先を作成します。

{
    "name": "my-cwl-destination",
    "deliveryDestinationConfiguration": {
        "destinationResourceArn": "arn:aws:logs:us-east-1:123456789012:log-group:/aws/aidevops/my-agent-space"
    },
    "outputFormat": "json"
}

次の例では、Amazon S3 送信先を作成します。

{
    "name": "my-s3-destination",
    "deliveryDestinationConfiguration": {
        "destinationResourceArn": "arn:aws:s3:::my-aidevops-logs-bucket"
    },
    "outputFormat": "json"
}

次の例では、Amazon Data Firehose の送信先を作成します。

{
    "name": "my-firehose-destination",
    "deliveryDestinationConfiguration": {
        "destinationResourceArn": "arn:aws:firehose:us-east-1:123456789012:deliverystream/my-aidevops-log-stream"
    },
    "outputFormat": "json"
}

CloudFormation を使用する場合は、以下を使用できます。

ResourceArn は AgentSpaceArn であり、APPLICATION_LOGS はサポートされているログタイプとして LogType にする必要があります。

ステップ 3: 配信を作成する

CreateDelivery オペレーションを使用して、配信ソースを配信先にリンクします。

{
    "deliverySourceName": "my-agent-space-delivery-source",
    "deliveryDestinationArn": "arn:aws:logs:us-east-1:123456789012:delivery-destination:my-cwl-destination"
}

AWS CloudFormation

次のリソースで AWS CloudFormation を使用してログ配信を設定することもできます。

ResourceArn を AWS DevOps エージェントスペースまたはサービス ARN に設定し、 LogType を に設定しますAPPLICATION_LOGS。

ログスキーマのリファレンス

AWS DevOps エージェントは、すべてのイベントタイプで共有ログスキーマを使用します。すべてのログイベントがすべてのフィールドを使用するわけではありません。

次の表に、ログスキーマのフィールドを示します。

ログ配信の管理と無効化

ログ配信は、 AWS マネジメントコンソールの AWS DevOps エージェントコンソールから、または CloudWatch Logs API を使用して、いつでも変更または削除できます。

ログ配信の管理 (コンソール)

ログ配信を無効にする (コンソール)

ログ配信を無効にする (API)

API を使用してログ配信を削除するには、次の順序でリソースを削除します。

料金

AWS DevOps エージェントは、提供されたログの有効化には課金しません。ただし、選択したログ配信先によっては、配信、取り込み、ストレージ、またはアクセスに対して料金が発生する場合があります。料金の詳細については、「Amazon CloudWatch 料金表」の「ログ」タブの「Vended Logs」を参照してください。 Amazon CloudWatch

送信先固有の料金については、以下を参照してください。