Skip to content

非公式 / UnofficialCloudflare, Inc. 非提携。アカウント情報は入力しないでください。Not affiliated with Cloudflare, Inc. Do not enter Cloudflare credentials here.Official docsこのサイトについてプライバシー

データセットを管理する

最終更新 Markdown で表示Agent セットアップ

Log Explorer では、Log Search でクエリできるデータセットを有効化、無効化、または削除できます。

対応データセット

Log Explorer は現在、次のデータセットに対応しています。

ゾーンレベル

アカウントレベル

Log Explorer を有効にする

ログの保存を始めるには、ダッシュボードまたは API で目的のデータセットを有効にします。

ダッシュボード

  1. Cloudflare ダッシュボードで Log Explorer > Manage datasets ページを開きます。

    公式ダッシュボードで Manage datasets を開く ↗
  2. Add dataset を選択します。

  3. データセットを選びます。ゾーンレベルのデータセットでは、ゾーンも選びます。

  4. Select fields で、Log Explorer が取り込むフィールドを選びます。

  5. Filter logs で、すべてのイベントを取り込むか、フィルターに一致するイベントだけを取り込むかを選びます。

  6. Add を選択します。

フィールドとフィルターを設定する

Select fields で、Log Explorer が保存するデータポイントを制御します。フィールドはカテゴリごとにグループ化され、各カテゴリには選択中のフィールド数が表示されます。カテゴリを選択すると、そのグループの全フィールドを追加または削除できます。カテゴリを展開して、個別のフィールドを選ぶこともできます。各フィールドにはデータ型が表示されます。

必須フィールドは選択されたままになり、Required と表示されます。Cloudflare が推奨しなくなったフィールドは Deprecated と表示されます。利用可能なすべてのフィールドを含めるには Select all を、データセットのデフォルトに戻すには Reset to default を選択します。

Filter logs で、All events を取り込むか、Only events matching a filter だけを取り込むかを選びます。フィルター条件は、フィールド、演算子、値で構成されます。グループ内の条件はすべて一致する必要があります。イベントは、いずれかのフィルターグループに一致すれば対象になります。

有効済みデータセットのフィールドまたはフィルターを変更するには、Log Explorer > Manage datasets を開きます。データセットを見つけ、Actions > Edit を選択し、設定を更新して Update を選択します。

API

保存したい各データセットを、Log Explorer API で有効にします。ログストリームを有効にしたあと、ログを表示できるようになるまで数分かかることがあります。

次の curl コマンドは、ゾーンレベルのデータセット http_requests を有効にする例と、成功時の想定レスポンスです。

curl https://api.cloudflare.com/client/v4/zones/{zone_id}/logs/explorer/datasets \
--header "Authorization: Bearer <API_TOKEN>" \
--json '{
  "dataset": "http_requests"
}'
{
	"result": {
		"dataset": "http_requests",
		"object_type": "zone",
		"object_id": "<ZONE ID>",
		"created_at": "2025-06-03T14:33:16Z",
		"updated_at": "2025-06-03T14:33:16Z",
		"dataset_id": "01973635f7e273a1964a02f4d4502499",
		"enabled": true,
		"deletion_protection": true
	},
	"success": true,
	"errors": [],
	"messages": []
}

アカウントレベルのデータセットを有効にするには、curl コマンド内の zones/{zone_id} を accounts/{account_id} に置き換えます。例:

curl https://api.cloudflare.com/client/v4/accounts/{account_id}/logs/explorer/datasets \
--header "Authorization: Bearer <API_TOKEN>" \
--json '{
  "dataset": "access_requests"
}'

データセットを削除する

データセットを削除すると、データセットとその保存データは完全に削除されます。削除は非同期で実行されます。削除の進行中は、同じデータセットをアカウントまたはゾーンに再作成できません。

  1. Cloudflare ダッシュボードで Log Explorer > Manage datasets を開きます。

    公式ダッシュボードで Manage datasets を開く ↗
  2. データセットを見つけ、Actions > Delete を選択します。

  3. 削除保護が有効な場合は、確認ダイアログで無効にします。

  4. データセット名を入力し、Delete を選択します。

  1. Update an account or zone dataset メソッドで deletion_protection を false に設定します。
  2. Delete an account or zone dataset メソッドでデータセットを削除します。

役に立ちましたか?