DocsDigest
Back to listLanguage: JA
OpenAICloudflare Developer PlatformApr 15, 2026, 12:00 AM

Privacy Proxy - Privacy Proxy metrics now available via GraphQL Analytics API

A condensed section focused on the key takeaways first.

Original Post
OpenAIClaude

Quick Digest

Summary

A condensed section focused on the key takeaways first.

openaienmodel: gpt-5-mini-2025-08-07

Privacy Proxy - Privacy Proxy metrics now available via GraphQL Analytics API

privacy-proxygraphqlanalyticsmetricsopentelemetryapi

Key Points

  • Privacy Proxy metrics available via GraphQL
  • Four new GraphQL metric nodes
  • GraphQL recommended over OpenTelemetry

Summary

Cloudflare now exposes Privacy Proxy observability via the GraphQL Analytics API (POST https://api.cloudflare.com/client/v4/graphql). This single, recommended endpoint lets engineers query Privacy Proxy metrics without running a collector—OpenTelemetry export remains available for existing pipelines.

Key Points

  • Endpoint: POST https://api.cloudflare.com/client/v4/graphql with header Authorization: Bearer <API_TOKEN> and JSON query/variables payload.
  • Four metric nodes available:
    • privacyProxyRequestMetricsAdaptiveGroups — request volume, error rates, status codes, proxy-status breakdowns.
    • privacyProxyIngressConnMetricsAdaptiveGroups — client→proxy connection counts, bytes, latency percentiles.
    • privacyProxyEgressConnMetricsAdaptiveGroups — proxy→origin connection counts, bytes, latency percentiles.
    • privacyProxyAuthMetricsAdaptiveGroups — authentication attempt counts by method and result.
  • Supported filters: time range (date_geq/date_leq), coloCode (data center), endpoint; nodes add extra dimensions (e.g., transport protocol, auth method).
  • Query options: supports limit (example uses 10000) and orderBy (e.g., date_ASC) for time-series aggregation.
  • Migration notes: GraphQL is the recommended default (plug-and-play, no collector infra). Keep OpenTelemetry exports while migrating dashboards/alerts.

Actionable guidance

  • Update dashboards and alert queries to call the GraphQL Analytics API and map the new node names to existing metrics.
  • Use time and colo filters to limit data returned and control costs; paginate or cap limit for large ranges.
  • Retain OpenTelemetry export until parity is validated, then decommission collectors if desired.

Full Translation

Translations

A translation section that keeps the flow of the original article.

openaijamodel: gpt-5-mini-2025-08-07

Privacy Proxy — GraphQL Analytics API で Privacy Proxy のメトリクスが利用可能に

Privacy Proxy のメトリクスが GraphQL Analytics API で利用可能に

Privacy Proxy のメトリクスは Cloudflare の GraphQL Analytics API からクエリ可能になりました。これは Privacy Proxy のオブザーバビリティデータにアクセスするための新しいデフォルトの方法です。すべてのメトリクスは単一のエンドポイントから取得できます。

例: curl でのクエリ

curl https://api.cloudflare.com/client/v4/graphql \
  --header "Authorization: Bearer <API_TOKEN>" \
  --header "Content-Type: application/json" \
  --data '{ "query": "{ viewer { accounts(filter: { accountTag: $accountTag }) { privacyProxyRequestMetricsAdaptiveGroups(filter: { date_geq: $startDate, date_leq: $endDate }, limit: 10000, orderBy: [date_ASC]) { count dimensions { date } } } } }", "variables": { "accountTag": "<YOUR_ACCOUNT_TAG>", "startDate": "2026-04-04", "endDate": "2026-04-06" } }'

利用可能なノード

  • privacyProxyRequestMetricsAdaptiveGroups — リクエストボリューム、エラー率、ステータスコード、プロキシステータスの内訳。
  • privacyProxyIngressConnMetricsAdaptiveGroups — クライアント→プロキシの接続数、転送バイト数、レイテンシのパーセンタイル。
  • privacyProxyEgressConnMetricsAdaptiveGroups — プロキシ→オリジンの接続数、転送バイト数、レイテンシのパーセンタイル。
  • privacyProxyAuthMetricsAdaptiveGroups — 認証試行のカウント（メソッド別および結果別）。

すべてのノードは時間、データセンター（coloCode）、エンドポイントでのフィルタリングをサポートし、トランスポートプロトコルや認証メソッドなど、ノード固有の追加ディメンションもサポートします。

既存の OpenTelemetry 利用者への影響

OpenTelemetry ベースのメトリクスエクスポートは引き続き利用可能です。GraphQL Analytics API は現在推奨されるデフォルトの方法であり、コレクタのインフラを必要としないプラグ・アンド・プレイの方法で、エンジニアリングの工数を節約します。

詳細とリソース

  • GraphQL Analytics API for Privacy Proxy
  • GraphQL Analytics API — getting started