OpenAICloudflare Developer Platform2026/04/15 0:00

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

要点だけを先に読めるように短く再構成したセクションです。

元記事

OpenAI Claude

Quick Digest

要約

要点だけを先に読めるように短く再構成したセクションです。

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

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

graphql privacy-proxy metrics observability opentelemetry api

Key Points

GraphQLで可視化
4つのメトリクスノード
OpenTelemetry併存

Summary

Privacy Proxy の観測データが Cloudflare の GraphQL Analytics API で取得可能になりました。すべてのメトリクスは単一の GraphQL エンドポイントからクエリでき、OpenTelemetry と併用可能です。GraphQL が推奨のデフォルト手段となり、collector を用意する必要がなく導入コストを下げられます。

Key Points

単一エンドポイントでメトリクス取得: /client/v4/graphql を経由
利用可能なノード（概要）:
- privacyProxyRequestMetricsAdaptiveGroups: リクエスト量、エラー率、ステータス、プロキシ状態
- privacyProxyIngressConnMetricsAdaptiveGroups: クライアント→プロキシ接続数、バイト数、遅延パーセンタイル
- privacyProxyEgressConnMetricsAdaptiveGroups: プロキシ→オリジン接続数、バイト数、遅延パーセンタイル
- privacyProxyAuthMetricsAdaptiveGroups: 認証試行数（方式・結果別）
フィルタ: 時間範囲、データセンター(coloCode)、エンドポイント、プロトコルや認証方式などノード固有の次元で絞り込み可能
OpenTelemetry は引き続き利用可能。GraphQL は collector 不要で運用負荷を軽減

Quick example

以下は最小限の curl 実行例（変数を置換してください）:

curl https://api.cloudflare.com/client/v4/graphql \
  -H "Authorization: Bearer <API_TOKEN>" \
  -H "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"}}'

Recommended actions

まず短い期間でクエリして使用可能な次元とスキーマを確認
大量データは limit と orderBy でページングを実装
既存の OpenTelemetry パイプラインはそのまま併用可能、必要に応じて段階的に GraphQL に移行

Full Translation

翻訳

原文の流れを保ったまま読める翻訳セクションです。

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