Skip to content

Commit 9026caa

Browse files
authored
[workers-observability] small copy improvements for section headings, change execution to invocation (#17246)
Co-authored-by: Rohin Lohe <[email protected]>
1 parent 33f9536 commit 9026caa

File tree

2 files changed

+11
-11
lines changed

2 files changed

+11
-11
lines changed

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ import { TabItem, Tabs, Steps } from "~/components";
1212

1313
With Real-time logs, access all your log events in near real-time for log events happening globally. Real-time logs is helpful for immediate feedback, such as the status of a new deployment.
1414

15-
Real-time logs captures [execution logs](/workers/observability/logs/workers-logs/#execution-logs), [custom logs](/workers/observability/logs/workers-logs/#add-custom-logs), errors, and uncaught exceptions. For high-traffic applications, real-time logs may enter sampling mode, which means some messages will be dropped and a warning will appear in your logs.
15+
Real-time logs captures [execution logs](/workers/observability/logs/workers-logs/#execution-logs), [custom logs](/workers/observability/logs/workers-logs/#custom-logs), errors, and uncaught exceptions. For high-traffic applications, real-time logs may enter sampling mode, which means some messages will be dropped and a warning will appear in your logs.
1616

1717
:::caution
1818

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

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ import { TabItem, Tabs, Steps, Render } from "~/components"
1515

1616
Workers Logs lets you automatically collect, store, filter, and analyze logging data emitted from Cloudflare Workers. Data is written to your Cloudflare Account, and you can query it in the dashboard for each of your Workers. All newly created Workers will come with the observability setting enabled by default.
1717

18-
Logs include [execution logs](/workers/observability/logs/workers-logs/#execution-logs), [custom logs](/workers/observability/logs/workers-logs/#add-custom-logs), errors, and uncaught exceptions.
18+
Logs include [invocation logs](/workers/observability/logs/workers-logs/#invocation-logs), [custom logs](/workers/observability/logs/workers-logs/#custom-logs), errors, and uncaught exceptions.
1919

2020
![Example showing the Workers Logs Dashboard](~/assets/images/workers-observability/preview.png)
2121

@@ -76,13 +76,13 @@ The difference between these examples is in how you index your logs to enable fa
7676

7777
## Features
7878

79-
### Execution Logs
79+
### Invocation Logs
8080

81-
Each Workers invocation returns a single execution log that contains details such as the Request, Response, and related metadata. These execution logs can be identified by the field `$cloudflare.$metadata.type = "cf-worker-event"`. Each execution log is enriched with information available to Cloudlare in the context of the invocation.
81+
Each Workers invocation returns a single invocation log that contains details such as the Request, Response, and related metadata. These invocation logs can be identified by the field `$cloudflare.$metadata.type = "cf-worker-event"`. Each invocation log is enriched with information available to Cloudflare in the context of the invocation.
8282

83-
In the Workers Logs UI, logs are presented with a localized timestamp and a message. The message is dependent on the invocation handler. For example, Fetch requests will have a message describing the request method and the request URL, while cron events will be listed as cron. Below is a list of invocation handlers along with their execution message.
83+
In the Workers Logs UI, logs are presented with a localized timestamp and a message. The message is dependent on the invocation handler. For example, Fetch requests will have a message describing the request method and the request URL, while cron events will be listed as cron. Below is a list of invocation handlers along with their invocation message.
8484

85-
| Invocation Handler | Execution Message |
85+
| Invocation Handler | Invocation Message |
8686
| --------------------------------------------------------------- | -------------------------- |
8787
| [Alarm](/durable-objects/api/alarms/) | \<Scheduled Time\> |
8888
| [Email](/email-routing/email-workers/runtime-api/) | \<Email Recipient\> |
@@ -93,9 +93,9 @@ In the Workers Logs UI, logs are presented with a localized timestamp and a mess
9393
| [RPC](/workers/runtime-apis/rpc/) | \<RPC method\> |
9494
| [WebSocket](/workers/examples/websockets/) | \<WebSocket Event Type\> |
9595

96-
### Add custom logs
96+
### Custom logs
9797

98-
By default a Worker will emit [execution logs](/workers/observability/logs/workers-logs/#execution-logs) containing details about the request, response and related metadata.
98+
By default a Worker will emit [invocation logs](/workers/observability/logs/workers-logs/#invocation-logs) containing details about the request, response and related metadata.
9999

100100
You can also add custom logs throughout your code. Any `console.log` statements within your Worker will be visible in Workers Logs. The following example demonstrates a custom `console.log` within a Worker request handler.
101101

@@ -174,11 +174,11 @@ Workers Logs billing will begin on November 1, 2024.
174174
:::
175175
<Render file="workers_logs_pricing" />
176176

177-
### Example Pricing
177+
### Examples
178178

179179
#### Example 1
180180

181-
A Worker serves 15 million requests per month. Each request emits 1 execution log and 1 `console.log`. `head_sampling_rate` is configured to 1.
181+
A Worker serves 15 million requests per month. Each request emits 1 invocation log and 1 `console.log`. `head_sampling_rate` is configured to 1.
182182

183183
| | Monthly Costs | Formula |
184184
| ---------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------- |
@@ -187,7 +187,7 @@ A Worker serves 15 million requests per month. Each request emits 1 execution lo
187187

188188
#### Example 2
189189

190-
A Worker serves 1 billion requests per month. Each request emits 1 execution log and 1 `console.log`. `head_sampling_rate` is configured to 0.1.
190+
A Worker serves 1 billion requests per month. Each request emits 1 invocation log and 1 `console.log`. `head_sampling_rate` is configured to 0.1.
191191

192192
| | Monthly Costs | Formula |
193193
| ---------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------- |

0 commit comments

Comments
 (0)