ログ・フィールドへのアクセス
要求内に fields が指定されていない場合、デフォルト・フィールドの制限されたセットが返されます。 すべての使用可能なフィールドを含む完全なリストは、次の要求を使用して取得してください。
ibmcloud cis logpush-available-fields DNS_DOMAIN_ID [--dataset DATASET] [-i, --instance INSTANCE]
データ・セット
これらの利用可能なデータセットは、ログカテゴリー別に利用可能なフィールドを説明しています
- HTTP / HTTPS へのリクエスト (
http_requests) - ファイアウォールイベント（
firewall_events） - イベントの範囲 (
range_events) - DNSログ（
dns_logs）
使用可能なフィールド
以下の表は、データセットごとに利用可能なフィールドを示しています。 ログフィールドは変更される場合があります。 「 利用可能なログフィールド API 」を使用して、利用可能なフィールドの最新バージョンを取得してください。
HTTP 要求
この表には、http_requests で利用可能なフィールドが記載されています。
| フィールド | 説明 | タイプ |
|---|---|---|
| BotDetectionIDs | リクエストで行われたボット管理ヒューリスティック検知に関連するIDのリスト。 ボットマネジメントのお客様のみご利用いただけます。 この機能を有効にするには、アカウント・チームにお問い合わせください。 | [arrayint] |
| BotDetectionTags | リクエストで行われたボット管理ヒューリスティック検知に関連するタグのリスト。 ボットマネジメントのお客様のみご利用いただけます。 この機能を有効にするには、アカウント・チームにお問い合わせください。 | [配列文字列] |
| BotScore | Cloudflareボットスコア 30未満のスコアは、一般的に自動生成されたトラフィックと関連付けられています。 ボットマネジメントのお客様のみご利用いただけます。 この機能を有効にするには、アカウント・チームにお問い合わせください。 | int |
| BotScoreSrc | Heuristics | ￤ ￤行動分析 ￤検証済みボット ￤JS Fingerprinting ￤Cloudflare Service. Machine Learning ボットマネジメントのお客様のみご利用いただけます。 この機能を有効にするには、アカウント・チームにお問い合わせください。 |
ストリング |
| BotTags | ボットトラフィックの種類（利用可能な場合）。 ボットマネジメントのお客様のみご利用いただけます。 この機能を有効にするには、アカウント・チームにお問い合わせください。 | [配列文字列] |
| CacheCacheStatus | miss expired updating stale hit ignored bypass revalidated dynamic stream_hit | ダイナミック(dynamic)" は、リクエストがキャッシュの対象外であることを意味する。
これは例えば、ファイアウォールによってブロックされたことを意味する。 |
ストリング |
| CacheReserveUsed | このリクエストの処理には、キャッシュリザーブが使用されました。 | ブール |
| CacheResponseBytes | キャッシュから返されるバイト数。 | int |
| CacheResponseStatus | HTTP キャッシュがエッジに返すステータスコード。 すべてのリクエスト（キャッシュできないものも含む）はキャッシュを経由する。 CacheCacheStatus。 | int |
| CacheTieredFill | このリクエストの処理には、階層型キャッシュが使用されました。 | ブール |
| ClientASN | クライアントAS番号 | int |
| ClientCity | クライアントのおおよその都市名 | ストリング |
| ClientCountry | クライアントIPアドレスの2文字 ISO-3166 国コード。 | ストリング |
| ClientDeviceType | クライアントデバイスのタイプ。 | ストリング |
| ClientIP | クライアントの IP アドレス。 | ストリング |
| ClientIPClass | badHost | searchEngine | allowlist | monitoringService | noRecord | scan | tor. |
ストリング |
| ClientLatitude | クライアントのおおよその緯度。 | ストリング |
| ClientLongitude | クライアントのおおよその経度。 | ストリング |
| ClientMTLSAuthCertFingerprint | mTLS 認証中にクライアントが提示した証明書の SHA256 フィンガープリント。 mTLS 接続の最初のリクエストにのみ入力される。 | ストリング |
| ClientMTLSAuthStatus | ok | absent | untrusted | notyetvalid | expired. |
ストリング |
| ClientRegionCode | ISO-3166-2 クライアントIPアドレスの地域コード。 | ストリング |
| ClientRequestBytes | クライアントのリクエストに含まれるバイト数。 | int |
| ClientRequestHost | クライアントからのホスト指定。 | ストリング |
| ClientRequestMethod | HTTP クライアントのリクエスト方法。 | ストリング |
| ClientRequestPath | クライアントがリクエストしたURIパス。リクエストされた URL のパス部分のみを含み、クエリー文字列は含まない。 | ストリング |
| ClientRequestProtocol | HTTP クライアントリクエストのプロトコル。 | ストリング |
| ClientRequestReferer | HTTP リファラーの取得。 | ストリング |
| ClientRequestScheme | 訪問者から依頼のあった「 URL 」スキーム。 | ストリング |
| ClientRequestSource | 外部ソースからのリクエストか、Cloudflare内の別のサービスからのリクエストかを識別します。 | ストリング |
| ClientRequestURI | クライアントからリクエストされたURI。これには、 TLS が含まれます。モード：エンドツーエンドのフレキシブルパス、およびリクエストされた URL のクエリ文字列。 | ストリング |
| ClientRequestUserAgent | クライアントから報告されたユーザーエージェント。 | ストリング |
| ClientSSLCipher | クライアントの SSL 暗号化。 | ストリング |
| ClientSSLProtocol | SSL （ TLS ）プロトコル。 値「none」は、 SSL が使用されなかったことを意味します。 | ストリング |
| ClientSrcPort | クライアントの送信元ポート。 | int |
| ClientTCPRTTMs | TCP の往復時間（SRTT）の平滑化平均値。 コネクションの最初のリクエストについては、コネクションのセットアップ中にのみ測定される。 同じコネクション上の後続のリクエストについては、そのリクエストが受 信されるまでのコネクションライフタイム全体にわたって測定される。 | int |
| ClientXRequestedWith | 「X-Requested-With」 HTTP ヘッダー。 | ストリング |
| ContentScanObjResults | コンテンツスキャン結果のリスト。 | [配列文字列] |
| ContentScanObjSizes | コンテンツオブジェクトのサイズのリスト。 | [arrayint] |
| ContentScanObjTypes | コンテンツタイプのリスト。 | [配列文字列] |
| Cookie | クッキーのキーと値のペアを文字列で指定します。 | オブジェクト |
| EdgeCFConnectingO2O | リクエストが Cloudflare エッジの複数のゾーンをループした場合は真。 これはオレンジからオレンジ( O2O )へのリクエストとみなされる。 | ブール |
| EdgeColoCode | リクエストを受信したデータセンターのIATA空港コード。 | ストリング |
| EdgeColoID | CloudflareエッジデータセンターID。 | int |
| EdgeEndTimestamp | エッジがクライアントへの応答の送信を完了した時刻。 | int or string |
| EdgePathingOp | このリクエストに対してどのような応答が返されたかを示します（unknown = 特定の処理は行われなかった）。 | ストリング |
| EdgePathingSrc | セキュリティチェックに基づいてリクエストがどのように分類されたかを詳細に示します（不明 = 特定の分類なし）。 | ストリング |
| EdgePathingStatus | このリクエストの処理を決定するためにどのデータが使用されたかを示します（unknown = データなし）。 | ストリング |
| EdgeRequestHost | エッジからオリジンへのリクエストに含まれるホストヘッダー。 | ストリング |
| EdgeResponseBodyBytes | クライアントに返される HTTP レスポンスボディのサイズ。 | int |
| EdgeResponseBytes | エッジからクライアントへ返されるバイト数。 | int |
| EdgeResponseCompressionRatio | エッジレスポンスの圧縮率は、元のレスポンスと圧縮されたレスポンスのサイズの比率として計算される。 | float |
| EdgeResponseContentType | エッジレスポンスの Content-Type ヘッダーの値。 | ストリング |
| EdgeResponseStatus | HTTP Cloudflareがクライアントに返すステータスコード。 | int |
| EdgeServerIP | オリジンに対してリクエストを送信しているエッジサーバーのIPアドレス。 可能なレスポンスは、 IPv4 または IPv6 形式の文字列、または空の文字列です。 空文字列は、オリジンサーバーへのリクエストがなかったことを意味する。 | ストリング |
| EdgeStartTimestamp | エッジがクライアントからリクエストを受信した時刻。 | int or string |
| EdgeTimeToFirstByteMs | Cloudflareのエッジで測定されたTime To First Byteのトータルビュー。 TCP 接続が確立された後に開始され、Cloudflareがエンドユーザーに対してレスポンスの最初のバイトの送信を開始した時点で終了します。 これには、 TLS のハンドシェイク時間（新規接続時）およびオリジンからの応答時間が含まれます。 | int |
| JA3Hash | SSL / TLS のクライアントのプロファイリングに使用される、 JA3 のフィンガープリントの MD5 ハッシュ。 ボットマネジメントのお客様のみご利用いただけます。 この機能を有効にするには、アカウント・チームにお問い合わせください。 | ストリング |
| JA4 | SSL / TLS のクライアントをプロファイリングするために使用される「 JA4 」フィンガープリント。 ボットマネジメントのお客様のみご利用いただけます。 この機能を有効にするには、アカウント・チームにお問い合わせください。 | ストリング |
| JA4Signals | この JA4 フィンガープリントについて計算されたリクエスト間統計。 JA4Signals フィールドはキーと値のペアで構成され、値は数値である。 ボットマネジメントのお客様のみご利用いただけます。 この機能を有効にするには、アカウント・チームにお問い合わせください。 | オブジェクト |
| JSDetectionPassed | failed |
がない。 ボットマネジメントのお客様のみご利用いただけます。 この機能を有効にするには、アカウント・チームにお問い合わせください。 |
| OriginDNSResponseTimeMs | オリジン名のDNS応答を受信するのにかかった時間。 通常は数ミリ秒かかるが、CNAMEレコードが使用されている場合はそれ以上かかることもある。 | int |
| OriginIP | オリジンサーバーのIPアドレス。 | ストリング |
| OriginRequestHeaderSendDurationMs | コネクション確立後、オリジンへのリクエストヘッダ送信にかかる時間。 なお、この値は通常 0 である。 |
int |
| OriginResponseBytes | オリジンサーバーから返されたバイト数。 | int |
| OriginResponseDurationMs | アップストリームの応答時間。リクエストを最初に受信したデータセンターから測定される。 スマート・ルーティングとティアード・キャッシュにかかる時間に加え、オリジン・サーバーへの接続とレスポンスの受信にかかる時間が含まれる。 このフィールドは OriginResponseTime に代わる。 | int |
| OriginResponseHTTPExpires | RFC1123 形式の「expires」ヘッダーの値。 | ストリング |
| OriginResponseHTTPLastModified | RFC1123 形式の「last-modified」ヘッダーの値。 | ストリング |
| OriginResponseHeaderReceiveDurationMs | Cloudflareがリクエストヘッダの送信を終了した後、オリジンがレスポンスヘッダを返すまでにかかる時間。 | int |
| OriginResponseStatus | アップストリームサーバーから返されたステータス。 値 0 は、オリジンサーバーからレスポンスが受信されず、Cloudflare's Edgeによってレスポンスが提供されたことを意味します。 しかしながら、ゾーン上でEdge関数が実行されている場合、値 0 は、オリジンに対して行われたEdge関数のサブリクエストの結果である可能性がある。 |
int |
| OriginResponseTime | 原点がエッジに応答を返すまでに要したナノ秒数。 | int |
| OriginSSLProtocol | SSL オリジンへの接続に使用される ( TLS ) プロトコル。 | ストリング |
| OriginTCPHandshakeDurationMs | オリジンとの TCP ハンドシェイクを完了するのにかかった時間。 オリジン接続が再利用される場合は、 0。 |
int |
| OriginTLSHandshakeDurationMs | オリジンとの TLS ハンドシェイクを完了するのにかかった時間。 オリジン接続が再利用される場合は、 0。 |
int |
| ParentRayID | このリクエストがEdge関数スクリプトを使用して行われた場合、親リクエストのRay ID。 | ストリング |
| RayID | リクエストのID。 | ストリング |
| RequestHeaders | RequestHeaders、文字列のキーと値のペア。 | オブジェクト |
| ResponseHeaders | ResponseHeaders、文字列のキーと値のペア。 | オブジェクト |
| SecurityAction | もしあれば、終了アクションをトリガーしたセキュリティルールのアクション。 | ストリング |
| SecurityActions | allow | block | challenge | jschallenge | log | connectionClose | challengeSolved | challengeBypassed | jschallengeSolved | jschallengeBypassed | bypass | managedChallenge | managedChallengeNonInteractiveSolved | managedChallengeInteractiveSolved | managedChallengeBypassed |
rewrite | forceConnectionClose | skip. |
[配列文字列] |
| SecurityRuleDescription | もしあれば、終了アクションをトリガーしたセキュリティルールの説明。 | ストリング |
| SecurityRuleID | 終了アクションをトリガーしたセキュリティー・ルールのルール ID (存在する場合)。 | ストリング |
| SecurityRuleIDs | リクエストにマッチしたセキュリティ製品のルールIDの配列。 ルール ID に関連するセキュリティ製品は、 SecuritySources で確認できる。 この配列の長さは、 SecurityActions および SecuritySources と同じです。 | [配列文字列] |
| SecuritySources | asn | country | ip | ipRange | securityLevel | zoneLockdown | waf | firewallRules | uaBlock | rateLimit | bic | hot | l7ddos | validation | botFight | apiShield | botManagement | dlp | firewallManaged | firewallCustom | apiShieldSchemaValidation | apiShieldTokenValidation | apiShieldSequenceMitigation. |
[配列文字列] |
| SmartRouteColoID | スマートルーティングが使用されている場合、オリジンサーバーへの接続に使用されるCloudflareデータセンター。 | int |
| UpperTierColoID | 階層キャッシュが使用されている場合、キャッシュ・コピーをチェックした「上位階層」データ・センター。 | int |
| VerifiedBotCategory | 検証済みボットのカテゴリー。 | ストリング |
| WAFAttackScore | WAF検出モジュールによって生成された総合リクエストスコア。 | int |
| WAFFlags | null. |
ストリング |
| WAFMatchedVar | TLS モード：直近で一致した変数のエンドツーエンドの柔軟な名前。 | ストリング |
| WAFRCEAttackScore | RCE 攻撃の WAF スコア。 | int |
| WAFSQLiAttackScore | SQLi攻撃に対するWAFのスコア。 | int |
| WAFXSSAttackScore | XSS攻撃に対するWAFのスコア。 | int |
| WorkerCPUTime | エッジ関数の実行に要した時間（ある場合）をマイクロ秒単位で示します。 | int |
| WorkerScriptName | リクエストを行ったEdge関数のスクリプト名。 | ストリング |
| WorkerStatus | Edgeファンクションデーモンから返されるステータス。 | ストリング |
| WorkerSubrequest | このリクエストがEdge関数のサブリクエストであったかどうか。 | ブール |
| WorkerSubrequestCount | このリクエストの処理中に、エッジ関数によって発行されたサブリクエストの数。 | int |
| WorkerWallTimeUs | Edge関数の呼び出しが開始されてから、Edge関数ランタイムが JavaScript、これ以上実行する必要がないと判断するまでの経過時間（マイクロ秒単位）。 具体的には、 JavaScript コンテキストが開いている壁時計の時間を測定する。 たとえば、大きなボディを持つレスポンスを返すとき、Edge関数のランタイムは、場合によっては、 JavaScript、これ以上実行する必要はないと判断し、すべてのバイトが通過して送信される前にJSコンテキストをクローズします。
あるいは、 waitUntil() APIを使用して、レスポンスの返 却をブロックせずに作業を実行する場合、この作業はレスポンスが返された後も実行され続け る可能性があり、 Edge functionWallTimeUs に含まれる。 |
int |
| ZoneName | 人間が読めるゾーン名(例: ' cloudflare.com ')。 | ストリング |
DNS ログ
この表には、dns_logs で利用可能なフィールドが記載されています。
| フィールド | 説明 | タイプ |
|---|---|---|
| ColoCode | リクエストを受信したデータセンターのIATA空港コード。 | ストリング |
| EDNSサブネット | IPv4 または、再帰リゾルバによって転送される IPv6 EDNSクライアントサブネット(ECS) に対応するアドレス情報。 すべてのリゾルバがこの情報を送るわけではない。 | ストリング |
| EDNSSubnetLength | ビット単位のEDNSクライアントサブネット（ECS）のサイズ。 例えば、 IPv4 アドレスの最後のオクテットが省略された場合（192.0.2.x. ）、サブネット長は 24 となる。 |
int |
| QueryName | 送信されたクエリの名前。 | ストリング |
| QueryType | クエリータイプの整数値。 詳しくは クエリータイプを 参照。 | int |
| ResponseCached | レスポンスがキャッシュされたかどうか。 | ブール |
| ResponseCode | 応答コードの整数値。 詳細は レスポンス コードを参照。 | int |
| SourceIP | クライアントのIPアドレス（ IPv4 または IPv6 ）。 | ストリング |
| タイムスタンプ | クエリが発生したタイムスタンプ。 | int or string |
「範囲」の要求
この表には、range_events で利用可能なフィールドが記載されています。
| フィールド | 説明 | タイプ |
|---|---|---|
| アプリケーション | イベントが発生したアプリケーションの固有のパブリックID。 | ストリング |
| ClientAsn | クライアントAS番号 | int |
| ClientBytes | Range サービスがクライアントから読み込んだバイト数。 | int |
| ClientCountry | クライアントのIPアドレスの国。 | ストリング |
| ClientIP | クライアントの IP アドレス。 | ストリング |
| ClientMatchedIpFirewall | ALLOW | BLOCK_ERROR | BLOCK_IP | BLOCK_COUNTRY | BLOCK_ASN | WHITELIST_IP | WHITELIST_COUNTRY | WHITELIST_ASN. |
ストリング |
| ClientPort | クライアントのポート。 | int |
| ClientProto | udp | unix. |
ストリング |
| ClientTcpRtt | TCP ：クライアントとRange間の往復時間（ナノ秒単位）。 | int |
| ClientTlsCipher | クライアントとRangeの間で合意された暗号方式。 未知の暗号は "UNK "として返される | ストリング |
| ClientTlsClientHelloServerName | クライアントからRangeへのClient Helloメッセージに含まれるサーバー名。 | ストリング |
| ClientTlsProtocol | none | SSLv3 | TLSv1 | TLSv1.1 | TLSv1.2 | TLSv1.3. |
ストリング |
| ClientTlsStatus | OK | INTERNAL_ERROR | INVALID_CONFIG | INVALID_SNI | HANDSHAKE_FAILED | KEYLESS_RPC. |
ストリング |
| ColoCode | リクエストを受信したデータセンターのIATA空港コード。 | ストリング |
| ConnectTimestamp | 接続の両端（クライアント／エッジ、エッジ／オリジン、またはネクストホップ）が確立されたタイムスタンプ。 | int or string |
| DisconnectTimestamp | 接続が切断された時刻。 | int or string |
| Event | connect | disconnect | clientFiltered | tlsError | resolveOrigin | originError. |
ストリング |
| IpFirewall | 接続時にIPファイアウォールが有効になっていたかどうか。 | ブール |
| OriginBytes | Range によって元データから読み込まれたバイト数。 | int |
| OriginIP | オリジンIPアドレス。 | ストリング |
| OriginPort | 原産地。 | int |
| OriginProto | udp | unix. |
ストリング |
| OriginTcpRtt | TCP ：Range と原点間の往復時間（ナノ秒単位）。 | int |
| OriginTlsCipher | Rangeと送信元との間で合意された暗号鍵。 未知の暗号は "UNK "として返される | ストリング |
| OriginTlsFingerprint | SHA256 発行元証明書のハッシュ値。 不明な SHA256 ハッシュは空文字列として返される。 | ストリング |
| OriginTlsMode | off | TLS モード：クライアントからエッジへ | TLS モード：エンドツーエンド（柔軟） | TLS モード：エンドツーエンド（CA署名付き）。 |
ストリング |
| OriginTlsProtocol | none | SSLv3 | TLSv1 | TLSv1.1 | TLSv1.2 | TLSv1.3. |
ストリング |
| OriginTlsStatus | OK | INTERNAL_ERROR | INVALID_CONFIG | INVALID_SNI | HANDSHAKE_FAILED | KEYLESS_RPC. |
ストリング |
| ProxyProtocol | v1 | v2 | simple. |
ストリング |
| ステータス | 接続が切断された理由を示すコード。 | int |
| タイムスタンプ | イベントが発生した時刻。 | int or string |
ファイアウォール・イベント
この表には、firewall_events で利用可能なフィールドが記載されています。
| フィールド | 説明 | タイプ |
|---|---|---|
| アクション | allow | block | challenge | jschallenge | log | connectionclose | challengesolved | challengebypassed | jschallengesolved | jschallengebypassed | bypass | managedchallenge | managedchallengenoninteractivesolved | managedchallengeinteractivesolved | managedchallengebypassed. |
ストリング |
| ClientASN | 訪問者のASN番号。 | int |
| ClientASNDescription | 訪問者のASNを文字列として。 | ストリング |
| ClientCountry | 要請の発信元国。 | ストリング |
| ClientIP | 訪問者のIPアドレス（ IPv4 または IPv6 ）。 | ストリング |
| ClientIPClass | badHost | searchEngine | allowlist | monitoringService | noRecord | scan | tor. |
ストリング |
| ClientRefererHost | refererホスト。 | ストリング |
| ClientRefererPath | 訪問者がリクエストしたリファラーのパス。 | ストリング |
| ClientRefererQuery | リファラーのクエリ文字列は、訪問者によってリクエストされました。 | ストリング |
| ClientRefererScheme | 訪問者がリクエストしたリファラー「 URL 」スキーム。 | ストリング |
| ClientRequestHost | 訪問者がリクエストしたホスト名「 HTTP 」。 | ストリング |
| ClientRequestMethod | 訪問者が使用した HTTP メソッド。 | ストリング |
| ClientRequestPath | 訪問者がリクエストしたパス。 | ストリング |
| ClientRequestProtocol | 訪問者が要求した HTTP プロトコルのバージョン。 | ストリング |
| ClientRequestQuery | このクエリ文字列は、訪問者によってリクエストされました。 | ストリング |
| ClientRequestScheme | 訪問者から依頼のあった「 URL 」スキーム。 | ストリング |
| ClientRequestUserAgent | 訪問者のユーザーエージェント文字列。 | ストリング |
| ContentScanObjResults | コンテンツスキャン結果のリスト。 | [配列文字列] |
| ContentScanObjSizes | コンテンツオブジェクトのサイズのリスト。 | [arrayint] |
| ContentScanObjTypes | コンテンツタイプのリスト。 | [配列文字列] |
| 日付 / 時刻 | エッジでイベントが発生した日時。 | int or string |
| 説明 | このリクエストによってトリガーされるルールの説明。 | ストリング |
| EdgeColoCode | このリクエストを処理したCloudflareデータセンターの空港コード。 | ストリング |
| EdgeResponseStatus | HTTP ブラウザに返されたレスポンスステータスコード。 | int |
| 種別 | イベントの種類。現在指定可能な値は以下の通り。 | ストリング |
| MatchIndex | ルールがチェーン内のインデックスと一致します。 最後のマッチングルールは MatchIndex 0 となる。 最後のルールの前に別のルールがマッチした場合、 MatchIndex 1となる。 他のマッチング・ルールも同様で、 MatchIndex の値は2、3、......となる。 |
int |
| メタデータ | 製品固有の追加情報。 メタデータは key:value のペアで編成されています。 キーと値の形式は、Cloudflareのセキュリティ製品によって異なり、また時間の経過とともに変更される場合があります。 | オブジェクト |
| OriginResponseStatus | HTTP ブラウザに返されたオリジンレスポンスのステータスコード。 | int |
| OriginatorRayID | challenge/jschallenge を発行したリクエストの RayID。 |
ストリング |
| RayID | リクエストの RayID。 | ストリング |
| Ref | このリクエストによってトリガーされるルールのユーザー定義識別子。 Cloudflareが提供する RuleID に加えて、refsを使用してルールを個別にラベル付けします。 いくつかのセキュリティ製品では、Rulesets APIを使って参照先を設定することができる。 | ストリング |
| RuleID | このリクエストによって、Cloudflareのセキュリティ製品固有の RuleID がトリガーされました。 | ストリング |
| ソース | asn | country | ip | iprange | securitylevel | zonelockdown | waf | firewallrules | uablock | ratelimit | bic | hot | l7ddos | validation | botfight | apishield | botmanagement | dlp | firewallmanaged | firewallcustom | apishieldschemavalidation | apishieldtokenvalidation | apishieldsequencemitigation. |
ストリング |