Skip to content

Commit 9dc92cd

Browse files
committed
wip
1 parent b388f1d commit 9dc92cd

File tree

4 files changed

+75
-2
lines changed

4 files changed

+75
-2
lines changed
Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
---
2+
pcx_content_type: navigation
3+
title: Investigate
4+
sidebar:
5+
order: 3
6+
group:
7+
hideIndex: false
8+
---
9+
10+
import { Badge, Stream } from "~/components";
11+
12+
Explore all your Workers telemetry data from the Cloudflare dashboard.
13+
14+
## [Query Builder](/workers/observability/investigate/query-builder) <Badge text="New" variant="tip" size="large" />
15+
16+
Write structured queries to investigate and visualize your telemetry data.
Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
---
2+
pcx_content_type: concept
3+
title: Query Builder
4+
head: []
5+
description: Write structured queries to investigate and visualize your telemetry data.
6+
sidebar:
7+
order: 1
8+
badge:
9+
variant: tip
10+
text: New
11+
12+
---
13+
14+
import { TabItem, Tabs, Steps, Render, WranglerConfig } from "~/components"
15+
16+
The Query Builder helps you write structured queries to investigate and visualize your telemtry data. The Query Builder searches the Workers Observability dataset, which currently includes all logs stored by [Workers Logs](/workers/observability/logs/workers-logs).
17+
18+
The Query Builder can be found in the [Workers' Observability tab in the Cloudflare dashboard](https://dash.cloudflare.com/?to=/:account/workers/services/view/:worker/observability/investigate).
19+
20+
## Enable Query Builder
21+
22+
The Query Builder is available to all developers and requires no enablement. Queries search all Workers Logs stored by Cloudflare. If you have not yet enabled Workers Logs, you can do so by adding the following setting to your [Worker's Wrangler file](/workers/observability/logs/workers-logs/#enable-workers-logs) and redeploying your Worker.
23+
24+
<WranglerConfig>
25+
```toml
26+
[observability]
27+
enabled = true
28+
29+
[observability.logs]
30+
invocation_logs = true
31+
head_sampling_rate = 1 # optional. default = 1.
32+
```
33+
</WranglerConfig>
34+
35+
## Write a Query
36+
37+
<Steps>
38+
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/?to=/:account/workers/services/view/:worker/observability/investigate/) and select your account.
39+
2. In Account Home, go to **Workers & Pages**.
40+
3. Select **Observability** in the left-hand navigation panel.
41+
</Steps>
42+
43+
## Composition of a Query
44+
45+
TODO
46+
47+
## Save Queries
48+
49+
TODO
50+
51+
## Share Queries
52+
53+
TODO
54+
55+
## Example 1
56+
57+
## Example 2

src/content/docs/workers/observability/logs/index.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ import { Badge, Stream } from "~/components";
1111

1212
Logs are an important component of a developer's toolkit to troubleshoot and diagnose application issues and maintaining system health. The Cloudflare Developer Platform offers many tools to help developers manage their application's logs.
1313

14-
## [Workers Logs](/workers/observability/logs/workers-logs) <Badge text="New" variant="tip" size="large" />
14+
## [Workers Logs](/workers/observability/logs/workers-logs)
1515

1616
Automatically ingest, filter, and analyze logs emitted from Cloudflare Workers in the Cloudflare dashboard.
1717

src/content/docs/workers/observability/logs/workers-logs.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -193,7 +193,7 @@ head_sampling_rate = 0.01 # 1% sampling rate
193193
| Maximum logs per account per day<sup>1</sup> | 5 Billion |
194194
| Maximum log size<sup>2</sup> | 128 KB |
195195

196-
<sup>1</sup> While Workers Logs is in open beta, there is a daily limit of 5 billion logs per account per day. After the limit is exceed, a 1% head-based sample will be applied for the remainder of the day.
196+
<sup>1</sup> There is a daily limit of 5 billion logs per account per day. After the limit is exceed, a 1% head-based sample will be applied for the remainder of the day.
197197

198198
<sup>2</sup> A single log has a maximum size limit of [128 KB](/workers/platform/limits/#log-size). Logs exceeding that size will be truncated and the log's `$cloudflare.truncated` field will be set to true.
199199

0 commit comments

Comments
 (0)