Privacy Gateway のメトリクス

Privacy Gateway は GraphQL API による詳細な監視に対応しており、ゲートウェイのトラフィックとパフォーマンスを把握できます。これらのメトリクスを使うには、次を用意してください。

• Cloudflare が Oblivious relay として動作する、リレーゲートウェイプロキシの実装。
• Analytics Read 権限を持つ API トークン。 メトリクス取得用の GraphQL ノードは ohttpMetricsAdaptive と ohttpMetricsAdaptiveGroups の 2 つです。前者はリクエスト単位の詳細データ、後者はグループ化した分析に使います。

ohttpMetricsAdaptive ノードは、適応的サンプリングで個々の OHTTP リクエストを詳しく確認するためのものです。サーバーとクライアントの構成における性能や負荷の把握に使えます。

• filter 必須
  • データセットを絞り込むフィルターです。accountTag は必須です。
• limit 任意
  • 返すレコード数の上限です。
• orderBy 任意
  • データの並べ替え方法です。各種ディメンションとメトリクスを選べます。

• bytesToClient int 任意
  • クライアントへ返したバイト数です。
• bytesToGateway int 任意
  • クライアントから受け取ったバイトの合計です。
• colo string 任意
  • リクエストを処理した Cloudflare データセンターの空港コードです。
• datetime Time 任意
  • イベントを記録した日時です。
• gatewayStatusCode int 任意
  • ゲートウェイが返したステータスコードです。
• relayStatusCode int 任意
  • リレーが返したステータスコードです。

このノードはトラフィックを細かく見るときに便利です。データフローのパターン、性能の問題、異常の特定に使えます。

ohttpMetricsAdaptiveGroups ノードは、適応的サンプリングで OHTTP リクエストメトリクスを集計します。トラフィックや運用のさまざまな軸で傾向やパターンを見るときに便利です。

• filter 必須
  • データセットを絞り込むフィルターです。accountTag は必須です。
• limit 任意
  • 返すレコード数の上限です。
• orderBy 任意
  • データの並べ替え方法です。各種ディメンションとメトリクスを選べます。

• count int 任意
  • 条件に合うレコード数です。
• dimensions 任意
  • データのグループ化に使うディメンションです。
• sum 任意
  • ディメンションごとの各種メトリクスの集計合計です。

ディメンション

メトリクスを次のディメンションでグループ化し、データを細かく分割できます。

• colo string 任意
  • Cloudflare データセンターの空港コードです。
• date Date 任意
  • OHTTP リクエストメトリクスの日付です。
• datetimeFifteenMinutes Time 任意
  • 15 分単位に切り詰めたタイムスタンプです。
• datetimeFiveMinutes Time 任意
  • 5 分単位に切り詰めたタイムスタンプです。
• datetimeHour Time 任意
  • 時間単位に切り詰めたタイムスタンプです。
• datetimeMinute Time 任意
  • 分単位に切り詰めたタイムスタンプです。
• endpoint string 任意
  • トラフィックを発生させた appId です。
• gatewayStatusCode int 任意
  • ゲートウェイが返したステータスコードです。
• relayStatusCode int 任意
  • リレーが返したステータスコードです。

合計フィールド

合計フィールドは、選んだ期間における各種メトリクスの累計です。

• bytesToClient int 任意
  • ゲートウェイからクライアントへ送ったバイトの合計です。
• bytesToGateway int 任意
  • クライアントからゲートウェイへ送ったバイトの合計です。
• clientRequestErrors int 任意
  • クライアントリクエストエラーの合計です。
• gatewayResponseErrors int 任意
  • ゲートウェイレスポンスエラーの合計です。

ohttpMetricsAdaptiveGroups ノードで、トラフィックパターンの集計した知見を得て、性能とユーザー体験の最適化に使えます。