dt-obs-network-flows

Network Flows スキル

Dynatrace のネットワークトラフィックを、3 つのフローデータソースにわたって分析します。このスキルでは、ネットワークフローで実現できるユースケースを説明し、各質問を適切なソースとリファレンスファイルに案内します。ソース固有の詳細な DQL は、リファレンスファイルに記載されています。

ネットワークフローでわかること

ネットワークフローデータは、メトリクスやトレースでは答えられない次のような質問に答えます。

• 誰が誰と通信しているか — ホスト、プロセス、ポッド、サービス、外部エンドポイント間の通信依存関係
• トラフィックの多いエンティティ — バイト数または接続数が最も多いトラフィックを生成しているエンティティ
• 接続の健全性 — 通信ごとのリセット、タイムアウト、再送、ラウンドトリップタイム（RTT）
• トラフィックの構成 — プロトコル（TCP/UDP）、宛先ポート、方向（クライアント対サーバー）
• ピアの特定 — 未加工の IP:ポートのピアを、監視対象のエンティティ（ホスト、プロセス、ポッド、サービス）に対応付けるか、外部として分類

---

3 つのフローソース

トラフィックの場所と収集元に応じてソースを選択します。複数のソースが該当する場合は、エンティティのコンテキストが最も豊富なソース（通常は OneAgent）を優先してください。

ソース	収集元	データの場所	エンティティのコンテキスト	使用する状況
OneAgent flows	ホスト上の OneAgent ネットワークエージェント	default_network_flows Grail バケット内のイベント	豊富 — 収集側のエンティティ（クライアントまたはサーバー）がホスト／プロセス／ポッドの Smartscape ID に解決され、リモートピアは IP:ポートとして記録されます	OneAgent が監視するホスト、プロセス、または Kubernetes ポッドとの間のトラフィック。デフォルトで最も詳細なソースです。
NetFlow / IPFIX / sFlow	ネットワークデバイス（スイッチ、ルーター）。OpenTelemetry Collector 経由で取り込み	ログ（otel.scope.name == "otelcol/netflowreceiver"。専用バケットへのルーティングを推奨）	デバイス／インターフェースレベル — 未加工の IP、エクスポーター、インターフェース。Smartscape エンティティはありません	ネットワーク機器で確認されたトラフィック。ネットワーク層の東西および南北のフローを対象とします。
Cloud flow logs	クラウドプロバイダー（AWS VPC / TGW。Azure、GCP はまだ未記載）	ログ（log.type == "aws.vpc" / "aws.tgw"。専用バケットへのルーティングを推奨）	クラウドリソースレベル — VPC / サブネット / AZ / ENI、TGW アタッチメント。未加工の IP が記録され、Smartscape エンティティはありません	エージェントのないマネージドサービスやリソースを含む、クラウドネットワーク内およびネットワーク間のトラフィック。

ルーティングロジック

1. トラフィックは OneAgent が監視するホスト、プロセス、またはポッドとの間のものですか？ → OneAgent フローを使用します。references/oneagent-flows/oneagent-flows.md を参照してください。
2. デバイスレベルのトラフィック、または監視対象外のホストからのトラフィックですか？ → NetFlow を使用します。references/netflow/netflow.md を参照してください。
3. クラウドネットワークまたはマネージドサービスのトラフィックですか？ → Cloud flow logs を使用します（プロバイダーごと）。AWS：references/cloud-flows/aws/aws.md。

3 つのソースは重複する場合があります。ポッド間のフローは、完全なポッドのコンテキストを含む OneAgent フローと、ENI 間のフローとして記録されるクラウドフローログの両方に現れることがあります。ユーザーが必要とするエンティティのコンテキストを提供するソースを優先し、主なソースにデータがない場合に限り、代替ソースに言及してください。

Dynatrace の関連ネットワークデータ

ネットワークフローは、Dynatrace のネットワークオブザーバビリティを構成する要素のひとつです。質問がフローに関するものでない場合は、以下を参照してください。

ユーザーが求めているもの…	参照先
ホスト NIC のスループット、リンク使用率、パケットのドロップ／エラー	dt-obs-hosts → references/host-metrics.md（Network Monitoring セクション）
プロセスレベルのネットワーク I/O と TCP 接続品質のメトリクス	dt-obs-hosts → references/process-monitoring.md
Kubernetes ポッドの接続とクラスターのネットワークトポロジー	dt-obs-kubernetes
サービスのリクエスト率、レイテンシー、エラー率	dt-obs-services
外部／合成の稼働状況およびネットワーク可用性のモニター	dt-obs-ext-monitors
ネットワークデバイス — スイッチ、ルーター、ファイアウォール（SNMP／モニタリング）	dt-obs-network-devices (計画中 — まだ利用できません)

今後、マクロな dt-obs-network スキルによって、ネットワークに関するすべての概念（デバイス、ホスト／プロセス／ポッドのメトリクス、フロー、可用性モニター、クラウドネットワークのモニタリング）をつなげられるようになる可能性があります。それが実現するまでは、このスキルにフロー固有の相互参照を掲載します。

---

参照ファイル

• references/oneagent-flows/oneagent-flows.md — 検証済み。 default_network_flows バケットのデータモデル、フィールドリファレンス、DQL を掲載しています。トップトーカー、トラフィックマップ、プロトコル／ポート別の内訳、接続の健全性（リセット／タイムアウト／再送／RTT）、bps 単位の帯域幅、フローのどちら側がピアにあたるかを扱います。

• references/peer-resolution/peer-resolution.md — 検証済み。 生のフロー IP（および任意のポート）を、モニタリング対象のホスト、プロセス、Kubernetes ポッド、またはサービスに解決する、共通の Smartscape ルックアップを掲載しています（ホスト → ポッド → サービス → 外部）。OneAgent フローと NetFlow の両方で使用します。

• references/oneagent-flows/configuration.md — builtin:network-connection-monitoring（OneAgent のフローデータを生成する設定）の有効化と調整方法を掲載しています。

• references/netflow/netflow.md — 検証済み。 OpenTelemetry Collector 経由で logs に取り込まれる NetFlow／IPFIX／sFlow のデータモデル、方向の意味（単方向で、クライアント／サーバーの役割なし）、トップの通信／トーカー／ポート、プロトコル別の内訳、時間経過に伴うトラフィック、エクスポーター別／インターフェース別のビューに関する DQL を掲載しています。

• references/netflow/configuration.md — OTel Collector の netflow レシーバーによる取り込み経路と、NetFlow ログを専用バケットにルーティングする推奨事項を掲載しています。

• references/cloud-flows/aws/aws.md — 検証済み（AWS）。 logs に取り込まれる AWS VPC Flow Logs と Transit Gateway フローログについて、aws.vpc／aws.tgw のフィールドモデル（pkt_srcaddr と srcaddr の違い、log_status によるフィルタリングを含む）、トップの通信／トーカー／ポート、拒否されたトラフィック（セキュリティ）、エグレスの traffic_path、VPC／サブネット／AZ 別、VPC 間、時間経過に伴うトラフィック、TGW のパケット損失に関する DQL を掲載しています。また、共通のピアルックアップで見つからないエージェントレスリソース向けに、ID または aws.object 内の IP アドレスで ENI／インスタンスを解決する AWS エンティティ解決についても説明しています。

• references/cloud-flows/aws/configuration.md — AWS フローログの Amazon Data Firehose による取り込み経路と、専用バケットにルーティングする推奨事項を掲載しています。

  (Azure NSG／VNet と GCP VPC のフローログはまだ文書化されていません。テナントデータを利用できるようになったら、兄弟フォルダーとして cloud-flows/<provider>/ を追加してください。)