Skip to content

Commit 658a199

Browse files
[Log Explorer] Adds permissions section (#25953)
* Adds permissions section * Apply suggestions from code review Co-authored-by: Pedro Sousa <[email protected]> --------- Co-authored-by: Pedro Sousa <[email protected]>
1 parent f85242b commit 658a199

File tree

2 files changed

+17
-7
lines changed

2 files changed

+17
-7
lines changed

src/content/docs/log-explorer/api.mdx

Lines changed: 2 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -9,15 +9,10 @@ Configuration and Log searches are also available via a public API.
99

1010
## Authentication
1111

12-
Log Explorer is available to users with the following permissions:
13-
14-
- **Logs Edit**: users with Logs Edit permissions can enable datasets.
15-
- **Logs Read**: users with Logs Read permissions can run queries via the UI or API.
16-
17-
Note that these permissions exist at the account and zone level and you need the appropriate permission level for the datasets you wish to query.
18-
1912
Authentication with the API can be done via an API token or API key with an email. Refer to [Create API token](/fundamentals/api/get-started/create-token/) for further instructions.
2013

14+
For detailed information on permissions required for each Log Explorer feature, refer to the [Permissions](/log-explorer/#permissions) section.
15+
2116
## Query data
2217

2318
Log Explorer includes a SQL API for submitting queries.

src/content/docs/log-explorer/index.mdx

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,21 @@ Log Explorer provides access to Cloudflare logs with all the context available w
2222

2323
Contract customers can choose to store their logs in Log Explorer for up to two years, at an additional cost of $0.10 per GB per month. Customers interested in this feature can contact their account team to have it added to their contract.
2424

25+
## Permissions
26+
27+
Access to Log Explorer features is controlled through specific permissions. Each permission grants users the ability to perform certain actions, such as querying logs, managing datasets, or creating dashboards.
28+
29+
| Feature | Required Permission | Description |
30+
|----------|--------------------|--------------|
31+
| **Manage datasets** | `Logs Edit` | Add, enable, or disable datasets. |
32+
| **Log Search** | `Logs Read` | Query logs in the dashboard or via API. |
33+
| **Log Search (save query)** | `Logs Write` | Save log search queries. |
34+
| **Custom dashboards** | `Analytics Read` | Create and view custom dashboards. |
35+
36+
These permissions apply across both the dashboard and the API, and must be granted at either the account or zone level depending on which datasets you need to access.
37+
38+
Authentication with the API can be done via an API token or API key with an email. Refer to [Create API token](/fundamentals/api/get-started/create-token/) for further instructions.
39+
2540
## Features
2641

2742
<Feature header="Log Search" href="/log-explorer/log-search/">

0 commit comments

Comments
 (0)