--- title: Observability --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/typescript) [Zones](https://developers.cloudflare.com/api/typescript/resources/zones) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Observability #### ObservabilityTracing #### ObservabilityTracingSettings ##### [View zone tracing settings](https://developers.cloudflare.com/api/typescript/resources/zones/subresources/observability/subresources/tracing/subresources/settings/methods/get) client.zones.observability.tracing.settings.get(SettingGetParams {zone\_id } params, RequestOptionsoptions?): [SettingGetResponse]() {destinations, enabled, forward\_context, 3 more } GET/zones/{zone\_id}/observability/tracing/settings ##### [Update zone tracing settings](https://developers.cloudflare.com/api/typescript/resources/zones/subresources/observability/subresources/tracing/subresources/settings/methods/update) client.zones.observability.tracing.settings.update(SettingUpdateParams {zone\_id, destinations, enabled, 4 more } params, RequestOptionsoptions?): [SettingUpdateResponse]() {destinations, enabled, forward\_context, 3 more } PATCH/zones/{zone\_id}/observability/tracing/settings ##### [Reset zone tracing settings](https://developers.cloudflare.com/api/typescript/resources/zones/subresources/observability/subresources/tracing/subresources/settings/methods/delete) client.zones.observability.tracing.settings.delete(SettingDeleteParams {zone\_id } params, RequestOptionsoptions?): [SettingDeleteResponse]() {destinations, enabled, forward\_context, 3 more } DELETE/zones/{zone\_id}/observability/tracing/settings ##### ModelsExpand Collapse
SettingGetResponse {destinations, enabled, forward\_context, 3 more } destinations: Array<string> Up to 100 OpenTelemetry destination identifiers that receive traces. Link to this property enabled: boolean Whether Cloudflare Traces is enabled for the zone. Link to this property forward\_context: boolean Whether trace context is sent externally or across a zone boundary. Link to this property persist: boolean Whether traces are persisted in Cloudflare. Link to this property
propagation\_policy: "accept"| "authenticated"| "reject" When inbound trace context may be continued. Authenticated propagation is not supported yet. One of the following: "accept" Link to this property "authenticated" Link to this property "reject" Link to this property
Link to this property sampling\_ratio: number The ratio of requests sampled for tracing, from 0 to 1. maximum1 minimum0 Link to this property
[Link to this property](<#(resource)%20zones.observability.tracing.settings%20%3E%20(model)%20setting_get_response%20%3E%20(schema)>)
SettingUpdateResponse {destinations, enabled, forward\_context, 3 more } destinations: Array<string> Up to 100 OpenTelemetry destination identifiers that receive traces. Link to this property enabled: boolean Whether Cloudflare Traces is enabled for the zone. Link to this property forward\_context: boolean Whether trace context is sent externally or across a zone boundary. Link to this property persist: boolean Whether traces are persisted in Cloudflare. Link to this property
propagation\_policy: "accept"| "authenticated"| "reject" When inbound trace context may be continued. Authenticated propagation is not supported yet. One of the following: "accept" Link to this property "authenticated" Link to this property "reject" Link to this property
Link to this property sampling\_ratio: number The ratio of requests sampled for tracing, from 0 to 1. maximum1 minimum0 Link to this property
[Link to this property](<#(resource)%20zones.observability.tracing.settings%20%3E%20(model)%20setting_update_response%20%3E%20(schema)>)
SettingDeleteResponse {destinations, enabled, forward\_context, 3 more } destinations: Array<string> Up to 100 OpenTelemetry destination identifiers that receive traces. Link to this property enabled: boolean Whether Cloudflare Traces is enabled for the zone. Link to this property forward\_context: boolean Whether trace context is sent externally or across a zone boundary. Link to this property persist: boolean Whether traces are persisted in Cloudflare. Link to this property
propagation\_policy: "accept"| "authenticated"| "reject" When inbound trace context may be continued. Authenticated propagation is not supported yet. One of the following: "accept" Link to this property "authenticated" Link to this property "reject" Link to this property
Link to this property sampling\_ratio: number The ratio of requests sampled for tracing, from 0 to 1. maximum1 minimum0 Link to this property
[Link to this property](<#(resource)%20zones.observability.tracing.settings%20%3E%20(model)%20setting_delete_response%20%3E%20(schema)>) #### ObservabilityTracingRules ##### [View zone trace rules](https://developers.cloudflare.com/api/typescript/resources/zones/subresources/observability/subresources/tracing/subresources/rules/methods/get) client.zones.observability.tracing.rules.get(RuleGetParams {zone\_id } params, RequestOptionsoptions?): [RuleGetResponse]() {rules } GET/zones/{zone\_id}/observability/tracing/rules ##### [Replace zone trace rules](https://developers.cloudflare.com/api/typescript/resources/zones/subresources/observability/subresources/tracing/subresources/rules/methods/update) client.zones.observability.tracing.rules.update(RuleUpdateParams {zone\_id, rules } params, RequestOptionsoptions?): [RuleUpdateResponse]() {rules } PUT/zones/{zone\_id}/observability/tracing/rules ##### [Delete zone trace rules](https://developers.cloudflare.com/api/typescript/resources/zones/subresources/observability/subresources/tracing/subresources/rules/methods/delete) client.zones.observability.tracing.rules.delete(RuleDeleteParams {zone\_id } params, RequestOptionsoptions?): [RuleDeleteResponse]() {rules } DELETE/zones/{zone\_id}/observability/tracing/rules ##### ModelsExpand Collapse
RuleGetResponse {rules }
rules: Array<Rule> Trace rules in evaluation order. action: "set\_trace\_settings" Link to this property
action\_parameters: ActionParameters {sampling\_ratio } sampling\_ratio: number The ratio of requests sampled for tracing, from 0 to 1. maximum1 minimum0 Link to this property
Link to this property description: string maxLength1000 Link to this property enabled: boolean Link to this property expression: string A Rules language expression that selects requests. maxLength4096 minLength1 Link to this property
Link to this property
[Link to this property](<#(resource)%20zones.observability.tracing.rules%20%3E%20(model)%20rule_get_response%20%3E%20(schema)>)
RuleUpdateResponse {rules }
rules: Array<Rule> Trace rules in evaluation order. action: "set\_trace\_settings" Link to this property
action\_parameters: ActionParameters {sampling\_ratio } sampling\_ratio: number The ratio of requests sampled for tracing, from 0 to 1. maximum1 minimum0 Link to this property
Link to this property description: string maxLength1000 Link to this property enabled: boolean Link to this property expression: string A Rules language expression that selects requests. maxLength4096 minLength1 Link to this property
Link to this property
[Link to this property](<#(resource)%20zones.observability.tracing.rules%20%3E%20(model)%20rule_update_response%20%3E%20(schema)>)
RuleDeleteResponse {rules }
rules: Array<Rule> Trace rules in evaluation order. action: "set\_trace\_settings" Link to this property
action\_parameters: ActionParameters {sampling\_ratio } sampling\_ratio: number The ratio of requests sampled for tracing, from 0 to 1. maximum1 minimum0 Link to this property
Link to this property description: string maxLength1000 Link to this property enabled: boolean Link to this property expression: string A Rules language expression that selects requests. maxLength4096 minLength1 Link to this property
Link to this property
[Link to this property](<#(resource)%20zones.observability.tracing.rules%20%3E%20(model)%20rule_delete_response%20%3E%20(schema)>)