From 0170ffd830ad695dcb2c9d9fb98260ada02f6499 Mon Sep 17 00:00:00 2001 From: Ming Lu Date: Wed, 23 Sep 2026 15:19:47 -0700 Subject: [PATCH 1/5] [AI Gateway] Distinguish current and legacy logs --- .../observability/logging/index.mdx | 64 ++++------------ .../observability/logging/legacy-logs.mdx | 61 +++++++++++++++ .../observability/logging/logpush.mdx | 6 +- .../docs/ai-gateway/reference/limits.mdx | 76 +++++++++++-------- .../docs/ai-gateway/reference/pricing.mdx | 18 +++-- 5 files changed, 136 insertions(+), 89 deletions(-) create mode 100644 src/content/docs/ai-gateway/observability/logging/legacy-logs.mdx diff --git a/src/content/docs/ai-gateway/observability/logging/index.mdx b/src/content/docs/ai-gateway/observability/logging/index.mdx index 3a226d93597..7930b043b09 100644 --- a/src/content/docs/ai-gateway/observability/logging/index.mdx +++ b/src/content/docs/ai-gateway/observability/logging/index.mdx @@ -8,18 +8,25 @@ products: import { Render } from "~/components"; -Logging is a fundamental building block for application development. Logs provide insights during the early stages of development and are often critical to understanding issues occurring in production. +Logs help you monitor requests and troubleshoot application issues. Each log can include the prompt, response, provider, timestamp, status, token usage, cost, duration, and user agent. -Your AI Gateway dashboard shows logs of individual requests, including the user prompt, model response, provider, timestamp, request status, token usage, cost, duration, and the user agent of the client that made the request. When [DLP](/ai-gateway/features/dlp/) policies are configured, logs for requests that trigger a DLP match also include the DLP action taken (Flag or Block), matched policy IDs, matched profile IDs, and the specific detection entries that were triggered. These logs persist, giving you the flexibility to store them for your preferred duration and do more with valuable request data. +When a request matches a [Data Loss Prevention (DLP)](/ai-gateway/features/dlp/) policy, its log can also include the action and matched policy details. -Each gateway has a storage limit based on your plan. You can customize this limit per gateway in your gateway settings. If your storage limit is reached, new logs will stop being saved. To continue saving logs, you must delete older logs to free up space for new logs. -To learn more about your plan limits, refer to [Limits](/ai-gateway/reference/limits/). +When [Guardrails](/ai-gateway/features/guardrails/) are turned on, Guardrails evaluation calls are also recorded in your logs. -We recommend using an authenticated gateway when storing logs to prevent unauthorized access and protects against invalid requests that can inflate log storage usage and make it harder to find the data you need. Learn more about setting up an [authenticated gateway](/ai-gateway/configuration/authentication/). +:::note[Log system by account creation date] +Cloudflare accounts created on or after September 24, 2026 use Logs powered by Workers Observability. For retention and pricing, refer to [Workers Logs pricing](/workers/observability/logs/workers-logs/#pricing). + +Cloudflare accounts created before September 24, 2026 use [Legacy Logs](/ai-gateway/observability/logging/legacy-logs/). +::: + +Use an [authenticated gateway](/ai-gateway/configuration/authentication/) to prevent unauthorized access. Authentication also prevents invalid requests from increasing log volume. ## Default configuration -Logs, which include metrics as well as request and response data, are enabled by default for each gateway. This logging behavior will be uniformly applied to all requests in the gateway. If you are concerned about privacy or compliance and want to turn log collection off, you can go to settings and opt out of logs. If you need to modify the log settings for specific requests, you can override this setting on a per-request basis. +Logs are enabled by default for each gateway. This setting applies to all requests unless a request overrides it. + +You can turn off collection for privacy or compliance requirements. @@ -91,48 +98,3 @@ If `cf-aig-collect-log` is set to `false`, the entire log entry (including metad When [Data Loss Prevention (DLP)](/ai-gateway/features/dlp/) policies are enabled on a gateway, log entries for requests that trigger a DLP policy match include additional fields: - -These fields are available both in the dashboard log viewer and through the [Logs API](/api/resources/ai_gateway/subresources/logs/methods/list/). You can filter logs by **DLP Action** in the dashboard to view only flagged or blocked requests. For more details on DLP monitoring, refer to [Monitor DLP events](/ai-gateway/features/dlp/set-up-dlp/#monitor-dlp-events). - -## Managing log storage - -To manage your log storage effectively, you can: - -- Set Storage Limits: Configure a limit on the number of logs stored per gateway in your gateway settings to ensure you only pay for what you need. -- Enable Automatic Log Deletion: Activate the Automatic Log Deletion feature in your gateway settings to automatically delete the oldest logs once the storage limit for your account is reached. This ensures new logs are always saved without manual intervention. - -## How to delete logs - -To manage your log storage effectively and ensure continuous logging, you can delete logs using the following methods: - -### Automatic Log Deletion - -​To maintain continuous logging within your gateway's storage constraints, enable Automatic Log Deletion in your Gateway settings. This feature automatically deletes the oldest logs once the storage limit for your account is reached, ensuring new logs are saved without manual intervention. - -### Manual deletion - -To manually delete logs through the dashboard, navigate to the Logs tab in the dashboard. Use the available filters such as status, cache, provider, cost, or any other options in the dropdown to refine the logs you wish to delete. Once filtered, select Delete logs to complete the action. - -See full list of available filters and their descriptions below: - -| Filter category | Filter options | Filter by description | -| --------------- | ------------------------------------------------------------ | --------------------------------------------------- | -| Status | error, status | error type or status. | -| Cache | cached, not cached | based on whether they were cached or not. | -| Provider | specific providers | the selected AI provider. | -| AI Models | specific models | the selected AI model. | -| Cost | less than, greater than | cost, specifying a threshold. | -| Request type | Workers AI Binding, WebSockets | the type of request. | -| Tokens | Total tokens, Tokens In, Tokens Out | token count (less than or greater than). | -| Duration | less than, greater than | request duration. | -| Feedback | equals, does not equal (thumbs up, thumbs down, no feedback) | feedback type. | -| Metadata Key | equals, does not equal | specific metadata keys. | -| Metadata Value | equals, does not equal | specific metadata values. | -| Log ID | equals, does not equal | a specific Log ID. | -| Event ID | equals, does not equal | a specific Event ID. | -| DLP Action | FLAG, BLOCK | the DLP action taken on the request. | -| User Agent | equals, does not equal, contains | the user agent of the client that made the request. | - -### API deletion - -You can programmatically delete logs using the AI Gateway API. For more comprehensive information on the `DELETE` logs endpoint, check out the [Cloudflare API documentation](/api/resources/ai_gateway/subresources/logs/methods/delete/). diff --git a/src/content/docs/ai-gateway/observability/logging/legacy-logs.mdx b/src/content/docs/ai-gateway/observability/logging/legacy-logs.mdx new file mode 100644 index 00000000000..5fe2b4c3c33 --- /dev/null +++ b/src/content/docs/ai-gateway/observability/logging/legacy-logs.mdx @@ -0,0 +1,61 @@ +--- +pcx_content_type: reference +title: Legacy Logs +description: Manage AI Gateway logs for accounts created before September 24, 2026. +products: + - ai-gateway +--- + +:::note[Account eligibility] +Legacy Logs applies only to Cloudflare accounts created before September 24, 2026. Accounts created on or after September 24, 2026 use [Logs](/ai-gateway/observability/logging/) powered by Workers Observability. +::: + +Legacy Logs provides an AI Gateway dashboard viewer and Logs API. To configure default collection or per-request headers, refer to [Logs](/ai-gateway/observability/logging/). + +## View request details + +The dashboard viewer shows individual requests for each gateway. It includes the shared request fields described in [Logs](/ai-gateway/observability/logging/). + +## Manage storage + +Each gateway has a configurable storage limit based on your plan. Workers Free accounts can store 100,000 logs across all gateways. Workers Paid accounts can store 10 million logs per gateway. + +Each stored log can be up to 10 MB. Legacy Logs does not store logs exceeding that size. + +Legacy Logs persists stored logs until you delete them. + +When you reach a storage limit, Legacy Logs can stop saving logs or automatically delete the oldest logs. If saving stops, delete stored logs before Legacy Logs can save more. + +For plan details, refer to [AI Gateway pricing](/ai-gateway/reference/pricing/#accounts-created-before-september-24-2026). + +## Delete logs automatically + +In your gateway settings, turn on **Automatic Log Deletion**. Legacy Logs deletes the oldest logs when your account reaches its storage limit. + +## Delete logs manually + +In the dashboard, open the gateway **Logs** tab. Apply filters, and then select **Delete logs**. + +The dashboard supports these filters: + +| Filter category | Filter options | Description | +| --------------- | ------------------------------------------------------------ | ---------------------------------------- | +| Status | Error, status | Matches an error type or status | +| Cache | Cached, not cached | Matches cache status | +| Provider | Specific providers | Matches an AI provider | +| AI models | Specific models | Matches an AI model | +| Cost | Less than, greater than | Compares cost with a threshold | +| Request type | Workers AI Binding, WebSockets | Matches the request type | +| Tokens | Total tokens, Tokens In, Tokens Out | Compares token count with a threshold | +| Duration | Less than, greater than | Compares duration with a threshold | +| Feedback | Equals, does not equal (thumbs up, thumbs down, no feedback) | Matches feedback | +| Metadata key | Equals, does not equal | Matches a metadata key | +| Metadata value | Equals, does not equal | Matches a metadata value | +| Log ID | Equals, does not equal | Matches a log ID | +| Event ID | Equals, does not equal | Matches an event ID | +| DLP action | `FLAG`, `BLOCK` | Matches the DLP action | +| User agent | Equals, does not equal, contains | Matches the requesting client user agent | + +## Use the Logs API + +The Legacy Logs API lets you [list stored logs](/api/resources/ai_gateway/subresources/logs/methods/list/). To delete matching logs programmatically, use the [`DELETE` logs endpoint](/api/resources/ai_gateway/subresources/logs/methods/delete/). diff --git a/src/content/docs/ai-gateway/observability/logging/logpush.mdx b/src/content/docs/ai-gateway/observability/logging/logpush.mdx index e4d40d04be8..eef83e5a5ce 100644 --- a/src/content/docs/ai-gateway/observability/logging/logpush.mdx +++ b/src/content/docs/ai-gateway/observability/logging/logpush.mdx @@ -11,9 +11,13 @@ import { Render, Tabs, TabItem } from "~/components"; AI Gateway allows you to securely export logs to an external storage location, where you can decrypt and process them. You can toggle Workers Logpush on and off in the [Cloudflare dashboard](https://dash.cloudflare.com) settings. This product is available on the Workers Paid plan. For pricing information, refer to [Pricing](/ai-gateway/reference/pricing). +Workers Logpush works with both [Logs](/ai-gateway/observability/logging/) and [Legacy Logs](/ai-gateway/observability/logging/legacy-logs/). + This guide explains how to set up Workers Logpush for AI Gateway, generate an RSA key pair for encryption, and decrypt the logs once they are received. -You can store up to 10 million logs per gateway. If your limit is reached, new logs will stop being saved and will not be exported through Workers Logpush. To continue saving and exporting logs, you must delete older logs to free up space for new logs. Workers Logpush has a limit of 4 jobs and a maximum request size of 1 MB per log. +For Legacy Logs on Workers Paid, you can store 10 million logs per gateway. If saving stops at this limit, logs are not saved or exported. Delete older logs or turn on automatic deletion to resume exports. + +Workers Logpush supports four jobs per account. Each exported log can be up to 1 MB. :::note[Note] diff --git a/src/content/docs/ai-gateway/reference/limits.mdx b/src/content/docs/ai-gateway/reference/limits.mdx index 973b2847192..838e115e786 100644 --- a/src/content/docs/ai-gateway/reference/limits.mdx +++ b/src/content/docs/ai-gateway/reference/limits.mdx @@ -12,37 +12,51 @@ import { Render } from "~/components"; The following limits apply to gateway configurations, logs, and related features in Cloudflare's platform. -## Gateway and log limits - -| Feature | Limit | -| --------------------------------------------------------------------- | ----------------------------------- | -| [Cacheable request size](/ai-gateway/features/caching/) | 25 MB per request | -| [Cache TTL](/ai-gateway/features/caching/#cache-ttl-cf-aig-cache-ttl) | 1 month | -| [Custom metadata](/ai-gateway/observability/custom-metadata/) | 5 entries per request | -| [Datasets](/ai-gateway/evaluations/set-up-evaluations/) | 10 per gateway | -| Gateways free plan | 10 per account | -| Gateways paid plan | 20 per account | -| Gateway name length | 64 characters | -| Log storage rate limit | 500 logs per second per gateway | -| [Unified Billing](/ai-gateway/features/unified-billing/) request rate | 200 requests per 60 seconds per gateway 4 | -| Logs stored [paid plan](/ai-gateway/reference/pricing/) | 10 million per gateway 1 | -| Logs stored [free plan](/ai-gateway/reference/pricing/) | 100,000 per account 2 | -| [Log size stored](/ai-gateway/observability/logging/) | 10 MB per log 3 | -| [Logpush jobs](/ai-gateway/observability/logging/logpush/) | 4 per account | -| [Logpush size limit](/ai-gateway/observability/logging/logpush/) | 1MB per log | - -1 When you reach the log storage limit for a gateway, you can -configure your gateway to either automatically delete the oldest logs to make -room for new ones, or stop saving new logs. You can also use -[Logpush](/ai-gateway/observability/logging/logpush/) to export logs to -external storage. Refer to [Automatic log deletion](/ai-gateway/observability/logging/#automatic-log-deletion) -for more details. - -2 On the free plan, the log storage limit applies to total logs across all gateways in your account. Same auto-delete or stop-saving behavior as 1. - -3 Logs larger than 10 MB will not be stored. - -4 This rate limit applies to requests that use Cloudflare-managed credentials through [Unified Billing](/ai-gateway/features/unified-billing/). When the limit is exceeded, AI Gateway returns a `429` error. This limit does not apply to requests that use your own provider keys through [bring your own keys (BYOK)](/ai-gateway/configuration/bring-your-own-keys/). +## Gateway limits + +| Feature | Limit | +| --------------------------------------------------------------------- | ---------------------------------------------------- | +| [Cacheable request size](/ai-gateway/features/caching/) | 25 MB per request | +| [Cache TTL](/ai-gateway/features/caching/#cache-ttl-cf-aig-cache-ttl) | 1 month | +| [Custom metadata](/ai-gateway/observability/custom-metadata/) | 5 entries per request | +| Gateways free plan | 10 per account | +| Gateways paid plan | 20 per account | +| Gateway name length | 64 characters | +| [Unified Billing](/ai-gateway/features/unified-billing/) request rate | 200 requests per 60 seconds per gateway 1 | + +1 This rate limit applies to requests that use Cloudflare-managed +credentials through [Unified Billing](/ai-gateway/features/unified-billing/). +When the limit is exceeded, AI Gateway returns a `429` error. This limit does +not apply to requests that use your own provider keys through [bring your own +keys (BYOK)](/ai-gateway/configuration/bring-your-own-keys/). + +## Log limits + +### Accounts created on or after September 24, 2026 + +These accounts use [Logs](/ai-gateway/observability/logging/) powered by Workers Observability. Refer to [Workers Logs limits](/workers/observability/logs/workers-logs/#limits) and [Workers Logs pricing](/workers/observability/logs/workers-logs/#pricing). + +### Accounts created before September 24, 2026 + +These accounts use [Legacy Logs](/ai-gateway/observability/logging/legacy-logs/). The following limits apply: + +| Feature | Limit | +| ---------------------- | ------------------------------- | +| Log storage rate | 500 logs per second per gateway | +| Logs stored, paid plan | 10 million per gateway | +| Logs stored, free plan | 100,000 per account | +| Stored log size | 10 MB per log | + +The free plan limit applies across all gateways. For behavior at these limits, refer to [Legacy Logs storage](/ai-gateway/observability/logging/legacy-logs/#manage-storage). + +## Logpush limits + +These limits apply to both Logs and Legacy Logs: + +| Feature | Limit | +| -------------------------------------------------------------- | ------------- | +| [Logpush jobs](/ai-gateway/observability/logging/logpush/) | 4 per account | +| [Logpush log size](/ai-gateway/observability/logging/logpush/) | 1 MB per log | ## DLP limits diff --git a/src/content/docs/ai-gateway/reference/pricing.mdx b/src/content/docs/ai-gateway/reference/pricing.mdx index 36dfc006c00..62a315ba480 100644 --- a/src/content/docs/ai-gateway/reference/pricing.mdx +++ b/src/content/docs/ai-gateway/reference/pricing.mdx @@ -1,7 +1,7 @@ --- pcx_content_type: reference title: Pricing -description: Review AI Gateway pricing, including free core features, persistent log storage limits, and premium add-ons. +description: Review AI Gateway pricing for logs and premium features. sidebar: order: 8 products: @@ -16,18 +16,24 @@ We will continue to build and expand AI Gateway. Some new features may be additi You can monitor your usage in the AI Gateway dashboard. -## Persistent logs +## Logs -Persistent logs are available on all plans. Log storage limits vary by plan. +Log pricing depends on your Cloudflare account creation date. -### Log storage limits +### Accounts created on or after September 24, 2026 + +These accounts use [Logs](/ai-gateway/observability/logging/) powered by Workers Observability. Refer to [Workers Logs pricing](/workers/observability/logs/workers-logs/#pricing) for current pricing and retention. + +### Accounts created before September 24, 2026 + +These accounts use [Legacy Logs](/ai-gateway/observability/logging/legacy-logs/). Persistent log storage is available on all plans with these limits: | Plan | Log storage limit | | ------------ | -------------------------------------- | | Workers Free | 100,000 logs total across all gateways | | Workers Paid | 10,000,000 logs per gateway | -For more details on log storage behavior and automatic log deletion, refer to [Limits](/ai-gateway/reference/limits/) and [Logging](/ai-gateway/observability/logging/#automatic-log-deletion). +For storage behavior and deletion options, refer to [Legacy Logs](/ai-gateway/observability/logging/legacy-logs/#manage-storage). ## Data Loss Prevention (DLP) @@ -45,7 +51,7 @@ A 5% fee is applied to all credits purchased through [Unified Billing](/ai-gatew ## Logpush -Logpush is only available on the Workers Paid plan. +Logpush works with both Logs and Legacy Logs. It is only available on the Workers Paid plan. | | Paid plan | | -------- | ---------------------------------- | From 61bc54cc22ff30fe93186c8961be43f54e938002 Mon Sep 17 00:00:00 2001 From: Ming Lu Date: Wed, 23 Sep 2026 16:01:58 -0700 Subject: [PATCH 2/5] [AI Gateway] Prioritize logging navigation --- src/content/docs/ai-gateway/observability/logging/index.mdx | 2 ++ 1 file changed, 2 insertions(+) diff --git a/src/content/docs/ai-gateway/observability/logging/index.mdx b/src/content/docs/ai-gateway/observability/logging/index.mdx index 7930b043b09..8a463a2cb0f 100644 --- a/src/content/docs/ai-gateway/observability/logging/index.mdx +++ b/src/content/docs/ai-gateway/observability/logging/index.mdx @@ -2,6 +2,8 @@ pcx_content_type: reference title: Logging description: Store and inspect AI Gateway request logs including prompts, responses, tokens, costs, and DLP actions. +sidebar: + order: 1 products: - ai-gateway --- From f1e213f7c4d02e81c70287ed7a31d1c169eb682f Mon Sep 17 00:00:00 2001 From: Ming Lu Date: Wed, 23 Sep 2026 16:05:18 -0700 Subject: [PATCH 3/5] [AI Gateway] Order observability navigation --- src/content/docs/ai-gateway/observability/analytics.mdx | 2 ++ src/content/docs/ai-gateway/observability/costs.mdx | 2 +- src/content/docs/ai-gateway/observability/custom-metadata.mdx | 2 +- .../docs/ai-gateway/observability/log-classification.mdx | 2 +- src/content/docs/ai-gateway/observability/otel-integration.mdx | 2 +- src/content/docs/ai-gateway/observability/user-insights.mdx | 2 +- 6 files changed, 7 insertions(+), 5 deletions(-) diff --git a/src/content/docs/ai-gateway/observability/analytics.mdx b/src/content/docs/ai-gateway/observability/analytics.mdx index db45596cbd4..6139e1b7f6e 100644 --- a/src/content/docs/ai-gateway/observability/analytics.mdx +++ b/src/content/docs/ai-gateway/observability/analytics.mdx @@ -2,6 +2,8 @@ title: Analytics description: View AI Gateway metrics for requests, tokens, caching, errors, and costs in the dashboard or via GraphQL. pcx_content_type: reference +sidebar: + order: 2 products: - ai-gateway --- diff --git a/src/content/docs/ai-gateway/observability/costs.mdx b/src/content/docs/ai-gateway/observability/costs.mdx index 595fcfa824f..02ea86df105 100644 --- a/src/content/docs/ai-gateway/observability/costs.mdx +++ b/src/content/docs/ai-gateway/observability/costs.mdx @@ -3,7 +3,7 @@ title: Costs description: Track and estimate token-based costs across AI providers using AI Gateway cost metrics. pcx_content_type: reference sidebar: - order: 2 + order: 3 products: - ai-gateway --- diff --git a/src/content/docs/ai-gateway/observability/custom-metadata.mdx b/src/content/docs/ai-gateway/observability/custom-metadata.mdx index 2d9d03048c4..32ab2af17d0 100644 --- a/src/content/docs/ai-gateway/observability/custom-metadata.mdx +++ b/src/content/docs/ai-gateway/observability/custom-metadata.mdx @@ -3,7 +3,7 @@ pcx_content_type: configuration title: Custom metadata description: Tag AI Gateway requests with custom metadata such as user IDs to improve log filtering and analysis. sidebar: - order: 4 + order: 6 products: - ai-gateway --- diff --git a/src/content/docs/ai-gateway/observability/log-classification.mdx b/src/content/docs/ai-gateway/observability/log-classification.mdx index b5f60e37e9d..7a4ba0ddc0a 100644 --- a/src/content/docs/ai-gateway/observability/log-classification.mdx +++ b/src/content/docs/ai-gateway/observability/log-classification.mdx @@ -3,7 +3,7 @@ title: Log classification description: Classify AI Gateway traffic by task and assess whether each model matches the task requirements. pcx_content_type: reference sidebar: - order: 3.5 + order: 5 badge: text: Beta variant: caution diff --git a/src/content/docs/ai-gateway/observability/otel-integration.mdx b/src/content/docs/ai-gateway/observability/otel-integration.mdx index 1a150bd093d..0f378e6e93d 100644 --- a/src/content/docs/ai-gateway/observability/otel-integration.mdx +++ b/src/content/docs/ai-gateway/observability/otel-integration.mdx @@ -3,7 +3,7 @@ title: OpenTelemetry description: Export AI Gateway trace spans to OpenTelemetry-compatible backends for distributed tracing and performance monitoring. pcx_content_type: configuration sidebar: - order: 5 + order: 7 products: - ai-gateway --- diff --git a/src/content/docs/ai-gateway/observability/user-insights.mdx b/src/content/docs/ai-gateway/observability/user-insights.mdx index 598ef81e717..beee7ce8672 100644 --- a/src/content/docs/ai-gateway/observability/user-insights.mdx +++ b/src/content/docs/ai-gateway/observability/user-insights.mdx @@ -3,7 +3,7 @@ title: User Insights description: Track organization-wide AI spend, attribute usage to identities, and detect anomalous sessions in AI Gateway. pcx_content_type: reference sidebar: - order: 3 + order: 4 products: - ai-gateway --- From f396a39555ee9ee033faf87a8abdaed06c29ae06 Mon Sep 17 00:00:00 2001 From: Ming Lu Date: Wed, 23 Sep 2026 16:22:23 -0700 Subject: [PATCH 4/5] [AI Gateway] Clarify logging terminology --- src/content/docs/ai-gateway/observability/logging/index.mdx | 2 +- .../docs/ai-gateway/observability/logging/legacy-logs.mdx | 2 +- src/content/docs/ai-gateway/reference/limits.mdx | 2 +- src/content/docs/ai-gateway/reference/pricing.mdx | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/src/content/docs/ai-gateway/observability/logging/index.mdx b/src/content/docs/ai-gateway/observability/logging/index.mdx index 8a463a2cb0f..ce836c9e1fb 100644 --- a/src/content/docs/ai-gateway/observability/logging/index.mdx +++ b/src/content/docs/ai-gateway/observability/logging/index.mdx @@ -17,7 +17,7 @@ When a request matches a [Data Loss Prevention (DLP)](/ai-gateway/features/dlp/) When [Guardrails](/ai-gateway/features/guardrails/) are turned on, Guardrails evaluation calls are also recorded in your logs. :::note[Log system by account creation date] -Cloudflare accounts created on or after September 24, 2026 use Logs powered by Workers Observability. For retention and pricing, refer to [Workers Logs pricing](/workers/observability/logs/workers-logs/#pricing). +For Cloudflare accounts created on or after September 24, 2026, AI Gateway logging follows [Workers Logs pricing and retention](/workers/observability/logs/workers-logs/#pricing). Cloudflare accounts created before September 24, 2026 use [Legacy Logs](/ai-gateway/observability/logging/legacy-logs/). ::: diff --git a/src/content/docs/ai-gateway/observability/logging/legacy-logs.mdx b/src/content/docs/ai-gateway/observability/logging/legacy-logs.mdx index 5fe2b4c3c33..4193edf9b79 100644 --- a/src/content/docs/ai-gateway/observability/logging/legacy-logs.mdx +++ b/src/content/docs/ai-gateway/observability/logging/legacy-logs.mdx @@ -7,7 +7,7 @@ products: --- :::note[Account eligibility] -Legacy Logs applies only to Cloudflare accounts created before September 24, 2026. Accounts created on or after September 24, 2026 use [Logs](/ai-gateway/observability/logging/) powered by Workers Observability. +Legacy Logs applies only to Cloudflare accounts created before September 24, 2026. For accounts created on or after that date, refer to [AI Gateway logging](/ai-gateway/observability/logging/). ::: Legacy Logs provides an AI Gateway dashboard viewer and Logs API. To configure default collection or per-request headers, refer to [Logs](/ai-gateway/observability/logging/). diff --git a/src/content/docs/ai-gateway/reference/limits.mdx b/src/content/docs/ai-gateway/reference/limits.mdx index 838e115e786..860ea9b00db 100644 --- a/src/content/docs/ai-gateway/reference/limits.mdx +++ b/src/content/docs/ai-gateway/reference/limits.mdx @@ -34,7 +34,7 @@ keys (BYOK)](/ai-gateway/configuration/bring-your-own-keys/). ### Accounts created on or after September 24, 2026 -These accounts use [Logs](/ai-gateway/observability/logging/) powered by Workers Observability. Refer to [Workers Logs limits](/workers/observability/logs/workers-logs/#limits) and [Workers Logs pricing](/workers/observability/logs/workers-logs/#pricing). +For accounts created on or after September 24, 2026, refer to [Workers Logs limits](/workers/observability/logs/workers-logs/#limits) and [Workers Logs pricing](/workers/observability/logs/workers-logs/#pricing). ### Accounts created before September 24, 2026 diff --git a/src/content/docs/ai-gateway/reference/pricing.mdx b/src/content/docs/ai-gateway/reference/pricing.mdx index 62a315ba480..cb5cdd87296 100644 --- a/src/content/docs/ai-gateway/reference/pricing.mdx +++ b/src/content/docs/ai-gateway/reference/pricing.mdx @@ -22,7 +22,7 @@ Log pricing depends on your Cloudflare account creation date. ### Accounts created on or after September 24, 2026 -These accounts use [Logs](/ai-gateway/observability/logging/) powered by Workers Observability. Refer to [Workers Logs pricing](/workers/observability/logs/workers-logs/#pricing) for current pricing and retention. +For accounts created on or after September 24, 2026, AI Gateway logging follows [Workers Logs pricing and retention](/workers/observability/logs/workers-logs/#pricing). ### Accounts created before September 24, 2026 From 5746493fcb2bace5374647ff19655442593cf981 Mon Sep 17 00:00:00 2001 From: Ming Lu Date: Wed, 23 Sep 2026 16:53:21 -0700 Subject: [PATCH 5/5] [AI Gateway] Define logging eligibility by gateway creation --- .../docs/ai-gateway/observability/logging/index.mdx | 6 +++--- .../ai-gateway/observability/logging/legacy-logs.mdx | 8 ++++---- .../ai-gateway/observability/logging/logpush.mdx | 2 +- src/content/docs/ai-gateway/reference/limits.mdx | 10 +++++----- src/content/docs/ai-gateway/reference/pricing.mdx | 12 ++++++------ 5 files changed, 19 insertions(+), 19 deletions(-) diff --git a/src/content/docs/ai-gateway/observability/logging/index.mdx b/src/content/docs/ai-gateway/observability/logging/index.mdx index ce836c9e1fb..f1775a0dedc 100644 --- a/src/content/docs/ai-gateway/observability/logging/index.mdx +++ b/src/content/docs/ai-gateway/observability/logging/index.mdx @@ -16,10 +16,10 @@ When a request matches a [Data Loss Prevention (DLP)](/ai-gateway/features/dlp/) When [Guardrails](/ai-gateway/features/guardrails/) are turned on, Guardrails evaluation calls are also recorded in your logs. -:::note[Log system by account creation date] -For Cloudflare accounts created on or after September 24, 2026, AI Gateway logging follows [Workers Logs pricing and retention](/workers/observability/logs/workers-logs/#pricing). +:::note[Logging eligibility] +New AI Gateway customers who create their first gateway on or after September 24, 2026 follow [Workers Logs pricing and retention](/workers/observability/logs/workers-logs/#pricing). -Cloudflare accounts created before September 24, 2026 use [Legacy Logs](/ai-gateway/observability/logging/legacy-logs/). +AI Gateway customers who created a gateway before September 24, 2026 use [Legacy Logs](/ai-gateway/observability/logging/legacy-logs/). ::: Use an [authenticated gateway](/ai-gateway/configuration/authentication/) to prevent unauthorized access. Authentication also prevents invalid requests from increasing log volume. diff --git a/src/content/docs/ai-gateway/observability/logging/legacy-logs.mdx b/src/content/docs/ai-gateway/observability/logging/legacy-logs.mdx index 4193edf9b79..ed819e139e4 100644 --- a/src/content/docs/ai-gateway/observability/logging/legacy-logs.mdx +++ b/src/content/docs/ai-gateway/observability/logging/legacy-logs.mdx @@ -1,20 +1,20 @@ --- pcx_content_type: reference title: Legacy Logs -description: Manage AI Gateway logs for accounts created before September 24, 2026. +description: Manage logs for AI Gateway customers who created a gateway before September 24, 2026. products: - ai-gateway --- :::note[Account eligibility] -Legacy Logs applies only to Cloudflare accounts created before September 24, 2026. For accounts created on or after that date, refer to [AI Gateway logging](/ai-gateway/observability/logging/). +Legacy Logs applies only to AI Gateway customers who created a gateway before September 24, 2026. Customers who create their first gateway on or after that date use [AI Gateway logging](/ai-gateway/observability/logging/). ::: -Legacy Logs provides an AI Gateway dashboard viewer and Logs API. To configure default collection or per-request headers, refer to [Logs](/ai-gateway/observability/logging/). +Legacy Logs provides an AI Gateway dashboard viewer and Logs API. To configure default collection or per-request headers, refer to [Logging](/ai-gateway/observability/logging/). ## View request details -The dashboard viewer shows individual requests for each gateway. It includes the shared request fields described in [Logs](/ai-gateway/observability/logging/). +The dashboard viewer shows individual requests for each gateway. It includes the shared request fields described in [Logging](/ai-gateway/observability/logging/). ## Manage storage diff --git a/src/content/docs/ai-gateway/observability/logging/logpush.mdx b/src/content/docs/ai-gateway/observability/logging/logpush.mdx index eef83e5a5ce..76d42043fef 100644 --- a/src/content/docs/ai-gateway/observability/logging/logpush.mdx +++ b/src/content/docs/ai-gateway/observability/logging/logpush.mdx @@ -11,7 +11,7 @@ import { Render, Tabs, TabItem } from "~/components"; AI Gateway allows you to securely export logs to an external storage location, where you can decrypt and process them. You can toggle Workers Logpush on and off in the [Cloudflare dashboard](https://dash.cloudflare.com) settings. This product is available on the Workers Paid plan. For pricing information, refer to [Pricing](/ai-gateway/reference/pricing). -Workers Logpush works with both [Logs](/ai-gateway/observability/logging/) and [Legacy Logs](/ai-gateway/observability/logging/legacy-logs/). +Workers Logpush works with [AI Gateway logging](/ai-gateway/observability/logging/) and [Legacy Logs](/ai-gateway/observability/logging/legacy-logs/). This guide explains how to set up Workers Logpush for AI Gateway, generate an RSA key pair for encryption, and decrypt the logs once they are received. diff --git a/src/content/docs/ai-gateway/reference/limits.mdx b/src/content/docs/ai-gateway/reference/limits.mdx index 860ea9b00db..3ee754588f5 100644 --- a/src/content/docs/ai-gateway/reference/limits.mdx +++ b/src/content/docs/ai-gateway/reference/limits.mdx @@ -32,13 +32,13 @@ keys (BYOK)](/ai-gateway/configuration/bring-your-own-keys/). ## Log limits -### Accounts created on or after September 24, 2026 +### New AI Gateway customers -For accounts created on or after September 24, 2026, refer to [Workers Logs limits](/workers/observability/logs/workers-logs/#limits) and [Workers Logs pricing](/workers/observability/logs/workers-logs/#pricing). +Customers who create their first gateway on or after September 24, 2026 follow [Workers Logs limits](/workers/observability/logs/workers-logs/#limits) and [Workers Logs pricing](/workers/observability/logs/workers-logs/#pricing). -### Accounts created before September 24, 2026 +### Existing AI Gateway customers -These accounts use [Legacy Logs](/ai-gateway/observability/logging/legacy-logs/). The following limits apply: +Customers who created a gateway before September 24, 2026 use [Legacy Logs](/ai-gateway/observability/logging/legacy-logs/). The following limits apply: | Feature | Limit | | ---------------------- | ------------------------------- | @@ -51,7 +51,7 @@ The free plan limit applies across all gateways. For behavior at these limits, r ## Logpush limits -These limits apply to both Logs and Legacy Logs: +These limits apply to all AI Gateway customers: | Feature | Limit | | -------------------------------------------------------------- | ------------- | diff --git a/src/content/docs/ai-gateway/reference/pricing.mdx b/src/content/docs/ai-gateway/reference/pricing.mdx index cb5cdd87296..90d34cfd8ed 100644 --- a/src/content/docs/ai-gateway/reference/pricing.mdx +++ b/src/content/docs/ai-gateway/reference/pricing.mdx @@ -18,15 +18,15 @@ You can monitor your usage in the AI Gateway dashboard. ## Logs -Log pricing depends on your Cloudflare account creation date. +Log pricing depends on when you created your first gateway. -### Accounts created on or after September 24, 2026 +### New AI Gateway customers -For accounts created on or after September 24, 2026, AI Gateway logging follows [Workers Logs pricing and retention](/workers/observability/logs/workers-logs/#pricing). +Customers who create their first gateway on or after September 24, 2026 follow [Workers Logs pricing and retention](/workers/observability/logs/workers-logs/#pricing). -### Accounts created before September 24, 2026 +### Existing AI Gateway customers -These accounts use [Legacy Logs](/ai-gateway/observability/logging/legacy-logs/). Persistent log storage is available on all plans with these limits: +Customers who created a gateway before September 24, 2026 use [Legacy Logs](/ai-gateway/observability/logging/legacy-logs/). Persistent log storage is available on all plans with these limits: | Plan | Log storage limit | | ------------ | -------------------------------------- | @@ -51,7 +51,7 @@ A 5% fee is applied to all credits purchased through [Unified Billing](/ai-gatew ## Logpush -Logpush works with both Logs and Legacy Logs. It is only available on the Workers Paid plan. +Logpush is available to all AI Gateway customers on the Workers Paid plan. | | Paid plan | | -------- | ---------------------------------- |