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

HLC エンドポイントを使用したログの送信 (HLC Logs)

HLC Logs エンドポイント (/services/collector/event) は、HTTP Log Collector (HLC) 形式に基づいています。

ベアラートークン認証を使用している場合は、続行するベアラートークン認証の設定前に のセットアップステップを完了してください。

入力モード

各イベントは、"event"必須フィールドを持つ JSON オブジェクトです。オプションのメタデータフィールド: "time"、"host"、"source"、"sourcetype"、"index"。

単一イベント:

{"event":"Hello world!","time":1486683865.0}

イベントの JSON 配列:

[
  {"event":"msg1","time":1486683865.0},
  {"event":"msg2","time":1486683866.0}
]

連結/バッチイベント (配列ラッパーなし):

{"event":"msg1","time":1486683865.0}{"event":"msg2","time":1486683866.0}

イベントフィールド (必須)

"event" フィールドは必須です。その値は任意の JSON タイプにすることができます。

{"event":"a string message"}
{"event":{"message":"structured data","severity":"INFO"}}
{"event":42}
{"event":true}

"event" フィールドのないオブジェクトはサイレントにスキップされます。

{"message":"this is skipped — no event field"}

時間フィールド (オプション)

"time" フィールドはエポック秒 (ミリ秒ではなく) で、オプションで 10 進数は 1 秒未満の精度です。

Content-Type

のみが受け入れられapplication/jsonます。

許容される JSON 値タイプ

エンドポイントフォーマット

HLC エンドポイント URL は次の形式に従います。

https://logs.<region>.amazonaws.com/services/collector/event?logGroup=<name>&logStream=<name>[&entityName=<name>&entityEnvironment=<environment>]

必須パラメータ:

オプションのパラメータ:

オプションで、次のクエリパラメータを含めることで、ログイベントをServiceエンティティに関連付けることができます。HLC エンドポイントを介して送信されるログはカスタムテレメトリであるため、自動的にエンティティに関連付けられません。これらのパラメータを指定することで、CloudWatch Logs は を KeyAttributes.Typeに設定してエンティティを作成しService、ログイベントに関連付けます。これにより、CloudWatch の Explore 関連機能は、これらのログを同じサービスの他のテレメトリ (メトリクス、トレース、ログ) と関連付けることができるため、さまざまなシグナルタイプのアプリケーションのトラブルシューティングとモニタリングが容易になります。エンティティおよび関連するテレメトリの詳細については、「カスタムテレメトリへの関連情報の追加」を参照してください。

リクエストの形式

次のヘッダーと本文を含む HTTP POST を使用してログを送信します。

ヘッダー:

本文形式:

リクエスト本文は、イベントの配列を含む JSON 形式である必要があります。

{
    "event": [
        {
            "time": 1730141374.001,
            "event": "Application started successfully",
            "host": "web-server-1",
            "source": "application.log",
            "severity": "info"
        },
        {
            "time": 1730141374.457,
            "event": "User login successful",
            "host": "web-server-1",
            "source": "auth.log",
            "user": "john.doe"
        }
    ]
}

フィールドの説明:

必要に応じて、追加のカスタムフィールドを含めることができます。

リクエスト例

curl -X POST "https://logs.<region>.amazonaws.com/services/collector/event?logGroup=MyLogGroup&logStream=MyStream" \
  -H "Authorization: Bearer ACWL<token>" \
  -H "Content-Type: application/json" \
  -d '{"event":{"message":"User logged in","user_id":"u-123"},"time":1486683865.0,"host":"web-01","source":"auth-service"}'

ベストプラクティス

イベントのバッチ処理

パフォーマンスと効率を向上させるには:

エラー処理

アプリケーションに適切なエラー処理を実装します。一般的な HTTP ステータスコード:

制限事項