予約フィールド

Log Service では、一部のフィールドは予約フィールドです。 API を使用してデータをログに書き込むときや Logtail 構成を追加するときは、必須フィールドの名前を予約済みフィールドの名前と同じにすることはできません。

注意事項

ログを収集するとき、または他のクラウド製品にデータを配信するとき、Log Service はログソースやタイムスタンプなどの情報をキーバリュー形式でログに追加できます。 _ Source __ など、固定名のフィールドは予約フィールドです。

API を使用してデータをログに書き込むとき、または Logtail 構成を追加するときは、必須フィールドの名前を予約済みフィールドの名前に使用しないようご注意ください。そうしなければ、クエリの結果が不正確になる可能性があります。
プレフィックスが __tag__ であるフィールドを配信することはできません。

次の表では、予約フィールドについて説明します。

表 1. 予約フィールド
予約フィールド	タイプ	インデックスと統計の設定	説明
`_ Time __`	標準の Unix 時間フォーマットの整数例：`__time__: 1523868463`	インデックス設定：このフィールドは API の from および to パラメータを通じて設定できるため、このフィールドにインデックスを追加する必要はありません。統計設定：デフォルトでは、他の列の統計機能が有効にされると、このフィールドの統計は自動的に有効化されます。	このフィールドは、API または SDK を使用してデータをログに書き込むときのログ生成時間を指定します。ログ配信、クエリ、および分析に使用できます。
`__source__`	String	インデックス設定：インデックス機能を有効にすると、Log Service はデフォルトでこのフィールドのインデックスを作成します。インデックスは text 型であり、区切り文字は指定されません。このフィールドをクエリする場合は、 `source:127.0.0.1` または `__source__:127.0.0.1` を入力します。統計設定：デフォルトでは、他の列の統計機能が有効にされると、このフィールドの統計は自動的に有効化されます。	このフィールドは、ログ収集元のデバイスを指定します。ログ配信、クエリ、分析、およびカスタム消費に使用できます。
`__topic__`	String	インデックス設定：インデックス機能を有効にすると、Log Service はデフォルトでこのフィールドのインデックスを作成します。インデックスは text 型であり、区切り文字は指定されません。このフィールドをクエリする場合は、`__topic__:XXX` を入力します。統計設定：デフォルトでは、他の列の統計機能が有効にされると、このフィールドの統計は自動的に有効化されます。	このフィールドはログトピックを指定します。ログトピックを設定した場合、Log Service は自動的にキーを `__topic__` に設定し、値を指定したトピックコンテンツとして設定したフィールドをログに追加します。このフィールドは、ログ配信、クエリ、分析、およびカスタム消費に使用できます。
`_extract_others_`	JSON マップに逆シリアル化できる文字列	このフィールドはどのログにも存在しないため、インデックスを追加する必要はありません。	このフィールドは `__extract_others__` と同じように機能します。 `__extract_others__` を使用することを推奨します。
`__tag__:__client_ip__`	String	インデックス設定：インデックス機能を有効にすると、Log Serviceはデフォルトですべての tags のインデックスを作成します。インデックスは text 型であり、区切り文字は指定されません。完全一致検索とあいまい検索の両方がサポートされています。統計設定：デフォルトでは、このフィールドで示される列の統計機能は無効になっています。このフィールドの統計を有効にする場合は、フィールドのインデックスを追加してから統計機能を有効にします。	このフィールドはシステムタグで、ログ収集元のデバイスのインターネット IP アドレスを指定します。インターネット IP アドレスの記録機能が有効になった後、サーバーはログを受信後生ログにこのフィールドを追加します。このフィールドは、ログのクエリ、分析、およびカスタム消費に使用できます。
`__tag__:__receive_time__`	標準の Unix 時間形式で整数に変換できる文字列	インデックス設定：インデックス機能を有効にすると、Log Serviceはデフォルトですべての tags のインデックスを作成します。インデックスは text 型であり、区切り文字は指定されません。完全一致検索とあいまい検索の両方がサポートされています。統計設定：デフォルトでは、この列の統計機能は無効になっています。このフィールドの統計を有効にする場合は、フィールドのインデックスを追加してから統計機能を有効にします。	このフィールドはシステム tag で、サーバーがログを受信する時刻を指定します。インターネット IP アドレスの記録機能が有効になった後、サーバーはログを受信後に生ログにこのフィールドを追加します。このフィールドは、ログのクエリ、分析、およびカスタム消費に使用できます。
`__tag__:__path__`	String	インデックス設定：インデックス機能を有効にすると、Log Service はデフォルトでこのフィールドのインデックスを作成します。インデックスは text 型であり、区切り文字は指定されません。このフィールドをクエリする場合は、 `__tag__:__path__:XXX` を入力します。統計設定：デフォルトでは、他の列の統計機能が有効にされると、このフィールドの統計は自動的に有効化されます。	このフィールドは、Logtail によって収集されたログファイルパスを指定します。 Logtail は自動的にこのフィールドをログに追加します。ログクエリ、分析、およびカスタム消費に使用できます。
`__tag__:__hostname__`	String	インデックス設定：インデックス機能を有効にすると、Log Service はデフォルトでこのフィールドのインデックスを作成します。インデックスは text 型であり、区切り文字は指定されません。このフィールドをクエリする場合は、 `__tag__:__hostname__:XXX` を入力します。統計設定：デフォルトでは、他の列の統計機能が有効にされると、このフィールドの統計は自動的に有効化されます。	このフィールドは、Logtail がデータを収集するホストの名前を指定します。 Logtail は自動的にこのフィールドをログに追加します。ログクエリ、分析、およびカスタム消費に使用できます。
`__raw_log__`	String	このフィールドに text タイプのインデックスを追加して設定し、必要に応じて統計機能を有効にする必要があります。	このフィールドは、解析に失敗した生ログを指定します。解析失敗機能付きログの破棄を無効にした後、Logtail はログ解析が失敗すると生ログをアップロードします。このフィールドでは、Key は `__raw_log__` で、Valueはログの内容です。このフィールドは、ログ配信、クエリ、分析、およびカスタム消費に使用できます。
`__raw__`	String	このフィールドに text タイプのインデックスを追加して設定し、必要に応じて統計機能を有効にする必要があります。	このフィールドは、正常に解析された生ログを示します。生ログのアップロード機能が有効になった後、Logtail は生ログをこのフィールドと見なし、正常に解析されたログとともにログをアップロードします。通常、このフィールドはログ監査とコンプライアンスチェックに使用されます。ログ配信、クエリ、分析、およびカスタム消費にも使用できます。