From 936cca338f26ea209604f7af0ba4591315bb3425 Mon Sep 17 00:00:00 2001 From: sahidya Date: Fri, 28 Aug 2026 13:29:52 -0400 Subject: [PATCH] [Log Explorer] Document dataset configuration improvements --- .../docs/log-explorer/manage-datasets.mdx | 31 ++++++++++++++++--- 1 file changed, 26 insertions(+), 5 deletions(-) diff --git a/src/content/docs/log-explorer/manage-datasets.mdx b/src/content/docs/log-explorer/manage-datasets.mdx index 3cd8819df01..5d6cec13343 100644 --- a/src/content/docs/log-explorer/manage-datasets.mdx +++ b/src/content/docs/log-explorer/manage-datasets.mdx @@ -8,7 +8,7 @@ products: - log-explorer --- -import { TabItem, Tabs, Render, DashButton } from "~/components"; +import { TabItem, Tabs, Render, DashButton, Steps } from "~/components"; Log Explorer allows you to enable, disable, or delete datasets available to query in Log Search. @@ -51,20 +51,41 @@ Log Explorer currently supports the following datasets: ## Enable Log Explorer -In order for Log Explorer to begin storing logs, you need to enable the desired datasets. You can do this via the dashboard or the API. +To begin storing logs, enable the desired datasets through the dashboard or API. + +### Dashboard + + 1. In the Cloudflare dashboard, go to the **Log Explorer** > **Manage datasets** page. -2. Select **Add dataset** to select the datasets you want to query. -3. Choose a dataset and then a zone. Then, select **Add**. You can always return to this page to enable more datasets or manage your existing ones. +2. Select **Add dataset**. +3. Choose a dataset and, for zone-level datasets, a zone. +4. Under **Select fields**, choose the fields that Log Explorer should ingest. +5. Under **Filter logs**, choose whether to ingest all events or only events that match a filter. +6. Select **Add**. + + :::note It may take a few minutes for the logs to become available for querying. ::: -If you are using the API, Use the Log Explorer API to enable Log Explorer for each dataset you wish to store. It may take a few minutes after a log stream is enabled before you can view the logs. +#### Configure fields and filters + +Use **Select fields** to control which data points Log Explorer stores. Fields are grouped by category, and each category shows its selected field count. Select a category to add or remove all fields in that group, or expand the category to select individual fields. Each field shows its data type. + +Required fields remain selected and are marked **Required**. Fields that Cloudflare no longer recommends are marked **Deprecated**. Select **Select all** to include every available field, or **Reset to default** to restore the dataset defaults. + +Use **Filter logs** to ingest **All events** or **Only events matching a filter**. A filter condition consists of a field, an operator, and a value. All conditions within a group must match. An event can match any filter group. + +To change the fields or filter for an enabled dataset, go to **Log Explorer** > **Manage datasets**. Find the dataset, select **Actions** > **Edit**, update the configuration, and select **Update**. + +### API + +Use the Log Explorer API to enable each dataset you want to store. It may take a few minutes after a log stream is enabled before you can view the logs. The following `curl` command is an example for enabling the zone-level dataset `http_requests`, as well as the expected response when the command succeeds.