--- title: Log Explorer --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Logs](https://developers.cloudflare.com/api/go/resources/logs) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Log Explorer #### Log ExplorerQuery ##### [Run a log query](https://developers.cloudflare.com/api/go/resources/logs/subresources/log_explorer/subresources/query/methods/sql) client.Logs.LogExplorer.Query.Sql(ctx, params) (\*SinglePage\[[LogExplorerQuerySqlResponse]()], error) POST/{accounts\_or\_zones}/{account\_or\_zone\_id}/logs/explorer/query/sql #### Log ExplorerDatasets ##### [List account or zone datasets](https://developers.cloudflare.com/api/go/resources/logs/subresources/log_explorer/subresources/datasets/methods/list) client.Logs.LogExplorer.Datasets.List(ctx, params) (\*SinglePage\[[DatasetSummary]()], error) GET/{accounts\_or\_zones}/{account\_or\_zone\_id}/logs/explorer/datasets ##### [Get an account or zone dataset](https://developers.cloudflare.com/api/go/resources/logs/subresources/log_explorer/subresources/datasets/methods/get) client.Logs.LogExplorer.Datasets.Get(ctx, datasetID, query) (\*[Dataset](), error) GET/{accounts\_or\_zones}/{account\_or\_zone\_id}/logs/explorer/datasets/{dataset\_id} ##### [Create an account or zone dataset](https://developers.cloudflare.com/api/go/resources/logs/subresources/log_explorer/subresources/datasets/methods/create) client.Logs.LogExplorer.Datasets.New(ctx, params) (\*[Dataset](), error) POST/{accounts\_or\_zones}/{account\_or\_zone\_id}/logs/explorer/datasets ##### [Update an account or zone dataset](https://developers.cloudflare.com/api/go/resources/logs/subresources/log_explorer/subresources/datasets/methods/update) client.Logs.LogExplorer.Datasets.Update(ctx, datasetID, params) (\*[Dataset](), error) PUT/{accounts\_or\_zones}/{account\_or\_zone\_id}/logs/explorer/datasets/{dataset\_id} ##### [Delete an account or zone dataset](https://developers.cloudflare.com/api/go/resources/logs/subresources/log_explorer/subresources/datasets/methods/delete) client.Logs.LogExplorer.Datasets.Delete(ctx, datasetID, body) (\*[Dataset](), error) DELETE/{accounts\_or\_zones}/{account\_or\_zone\_id}/logs/explorer/datasets/{dataset\_id} ##### ModelsExpand Collapse
type CreateRequest struct{…} Dataset string Dataset type name to create (e.g. http_requests). Link to this property
Fields \[]CreateRequestFieldOptional Controls which fields the API ingests. Defaults to all available fields when absent. Enabled bool Whether the API includes this field in log ingest. Link to this property Name string Field name in lowercase. Link to this property
Link to this property Filter stringOptional Optional Logpush filter predicate to restrict which events are ingested. See Logpush filters for syntax and examples. Link to this property FilterAttackTraffic boolOptional Whether to filter attack traffic from the Logpush job. Defaults to true for supported datasets when omitted. Supported datasets are http_requests, firewall_events, and network_analytics_logs. Link to this property
[Link to this property](<#(resource)%20logs.log_explorer.datasets%20%3E%20(model)%20create_request%20%3E%20(schema)>)
type Dataset struct{…} A Log Explorer dataset summary. List endpoints return this type and omit field configuration; use the single-dataset endpoint to retrieve it. CreatedAt Time RFC3339 timestamp recording when the API created this dataset. formatdate-time Link to this property Dataset string Dataset type name (e.g. http_requests). Link to this property DatasetID string Unique dataset ID. Link to this property DeletionProtection bool Whether deletion is blocked. Set to false before deleting the dataset. Link to this property Enabled bool Whether log ingest is currently active for this dataset. Link to this property
Fields \[]DatasetField The field configuration for this dataset. Enabled bool Whether the API includes this field in log ingest. Link to this property Name string Field name in lowercase. Link to this property
Link to this property ObjectID string Public ID of the account or zone that owns this dataset. Link to this property
ObjectType DatasetObjectType Whether this dataset belongs to an account or a zone. One of the following: const DatasetObjectTypeAccount DatasetObjectType = "account" Link to this property const DatasetObjectTypeZone DatasetObjectType = "zone" Link to this property
Link to this property UpdatedAt Time RFC3339 timestamp recording when the API last updated this dataset. formatdate-time Link to this property Filter stringOptional The Logpush filter predicate applied to this dataset. Omitted when no filter is set. Link to this property FilterAttackTraffic boolOptional Whether the Logpush job filters attack traffic. Omitted for datasets that do not support this option. Link to this property
[Link to this property](<#(resource)%20logs.log_explorer.datasets%20%3E%20(model)%20dataset%20%3E%20(schema)>)
type DatasetSummary struct{…} A Log Explorer dataset summary. List endpoints return this type and omit field configuration; use the single-dataset endpoint to retrieve it. CreatedAt Time RFC3339 timestamp recording when the API created this dataset. formatdate-time Link to this property Dataset string Dataset type name (e.g. http_requests). Link to this property DatasetID string Unique dataset ID. Link to this property DeletionProtection bool Whether deletion is blocked. Set to false before deleting the dataset. Link to this property Enabled bool Whether log ingest is currently active for this dataset. Link to this property ObjectID string Public ID of the account or zone that owns this dataset. Link to this property
ObjectType DatasetSummaryObjectType Whether this dataset belongs to an account or a zone. One of the following: const DatasetSummaryObjectTypeAccount DatasetSummaryObjectType = "account" Link to this property const DatasetSummaryObjectTypeZone DatasetSummaryObjectType = "zone" Link to this property
Link to this property UpdatedAt Time RFC3339 timestamp recording when the API last updated this dataset. formatdate-time Link to this property
[Link to this property](<#(resource)%20logs.log_explorer.datasets%20%3E%20(model)%20dataset_summary%20%3E%20(schema)>)
type UpdateRequest struct{…} Enabled bool Whether to enable or disable log ingest for this dataset. Link to this property DeletionProtection boolOptional Set to false to allow deletion of this dataset. Link to this property
Fields \[]UpdateRequestFieldOptional Controls which fields the API ingests after the update. Defaults to all available fields when absent. Enabled bool Whether the API includes this field in log ingest. Link to this property Name string Field name in lowercase. Link to this property
Link to this property Filter stringOptional Optional Logpush filter predicate to restrict which events are ingested. If omitted, the existing filter is left unchanged. Set to an empty string ("") to clear the filter. Otherwise, replaces the dataset’s filter entirely. See Logpush filters for syntax and examples. Link to this property FilterAttackTraffic boolOptional Whether to filter attack traffic from the Logpush job. If omitted, the existing setting is left unchanged. Supported datasets are http_requests, firewall_events, and network_analytics_logs. Link to this property
[Link to this property](<#(resource)%20logs.log_explorer.datasets%20%3E%20(model)%20update_request%20%3E%20(schema)>) #### Log ExplorerDatasetsAvailable ##### [List available account or zone datasets](https://developers.cloudflare.com/api/go/resources/logs/subresources/log_explorer/subresources/datasets/subresources/available/methods/list) client.Logs.LogExplorer.Datasets.Available.List(ctx, query) (\*SinglePage\[[AvailableDataset]()], error) GET/{accounts\_or\_zones}/{account\_or\_zone\_id}/logs/explorer/datasets/available ##### ModelsExpand Collapse
type AvailableDataset struct{…} A dataset type that the account or zone can create. Dataset string Dataset type name (e.g. http_requests). Link to this property
ObjectType AvailableDatasetObjectType Whether this dataset type is account-scoped or zone-scoped. One of the following: const AvailableDatasetObjectTypeAccount AvailableDatasetObjectType = "account" Link to this property const AvailableDatasetObjectTypeZone AvailableDatasetObjectType = "zone" Link to this property
Link to this property
Schema AvailableDatasetSchema JSON Schema that describes the fields this dataset exposes. Properties map\[string, unknown]Optional Link to this property Required \[]stringOptional Link to this property Type AvailableDatasetSchemaTypeOptional Link to this property
Link to this property TimestampField string The primary timestamp field name for this dataset. Link to this property
[Link to this property](<#(resource)%20logs.log_explorer.datasets.available%20%3E%20(model)%20available_dataset%20%3E%20(schema)>)
type AvailableList struct{…}
Errors \[]ResponseInfo Code int64 minimum1000 Link to this property Message string Link to this property DocumentationURL stringOptional Link to this property
Source ResponseInfoSourceOptional Pointer stringOptional Link to this property
Link to this property
Link to this property Messages \[]string Link to this property Success bool Link to this property
Result \[]AvailableDatasetOptional Dataset string Dataset type name (e.g. http_requests). Link to this property
ObjectType AvailableDatasetObjectType Whether this dataset type is account-scoped or zone-scoped. One of the following: const AvailableDatasetObjectTypeAccount AvailableDatasetObjectType = "account" Link to this property const AvailableDatasetObjectTypeZone AvailableDatasetObjectType = "zone" Link to this property
Link to this property
Schema AvailableDatasetSchema JSON Schema that describes the fields this dataset exposes. Properties map\[string, unknown]Optional Link to this property Required \[]stringOptional Link to this property Type AvailableDatasetSchemaTypeOptional Link to this property
Link to this property TimestampField string The primary timestamp field name for this dataset. Link to this property
Link to this property
[Link to this property](<#(resource)%20logs.log_explorer.datasets.available%20%3E%20(model)%20available_list%20%3E%20(schema)>)