Skip to main content
client.apps.network は Web アプリでのみ機能します。すべてのメソッドは第 1 引数にアプリ ID を取ります。

期間

analytics、errors、logs、performance は start と end を取り、それぞれ ISO 8601 文字列または datetime を指定します。naive な datetime はローカル時刻として扱われ、UTC に変換されます。期間は最大 7 日で、start はアプリの作成日より前にならないよう切り詰められます。無効な期間は 400 INVALID_TIME_RANGE になります。
結果は 5 分単位でキャッシュされます。これら 4 つのメソッドのキャッシュミスは、アカウントごとに 60 秒あたり 20 リクエストの制限を共有しており、超過すると 429 RATE_LIMITED になります。

アナリティクス

network.analytics(app_id, start, end, **filters) は、トラフィックの合計と内訳を返します。トラフィックのない期間では None を返します。
内訳は countries、devices、os、browsers、protocols、methods、paths、referers、providers、ips、status_codes、bots、content_types です。各バケットには type、visits、requests、bytes があります。

フィルター

フィルターはキーワード引数で、すべての内訳を絞り込みます。各フィルターには、対応する内訳の type の値をそのまま指定します:
無効なフィルターは 400 INVALID_FILTER になります。None または '' に設定したフィルターは送信されません。

エラー

network.errors(app_id, start, end, include_4xx=False) は期間内の 5xx レスポンスを返し、include_4xx=True (キーワード専用) を指定すると 4xx も含めます。空の期間では None を返します。

リクエストログ

network.logs(app_id, start, end) は、クライアント、リクエスト、レスポンスの詳細を含む個々のリクエストを返します。Pro プランと Enterprise プランで利用できます (それ以外では 403 UPGRADE_REQUIRED)。

パフォーマンス

network.performance(app_id, start, end) は、エッジとオリジンでのレイテンシーのパーセンタイル (p50、p95、p99、ミリ秒) を、国別、ロケーション別、最も遅いパス別に返します。空の期間では None を返します。Pro プランと Enterprise プランで利用できます。

DNS

network.dns(app_id) は、カスタムドメインに必要な DNS レコードをそのステータスとともに返します。カスタムドメインがない場合は 400 NO_CUSTOM_DOMAIN になります。

カスタムドメイン

network.set_domain(app_id, domain) はカスタムドメインを設定します (Standard プラン以上)。削除するには "@" を渡します。

キャッシュのパージ

network.purge_cache(app_id) はアプリのエッジキャッシュを消去します。パージは 60 秒に 1 回までに制限されています (429 KEEP_CALM)。

アナリティクス系メソッドのエラー