cloud-network-insights

Cloud Network Insights

Attribution

このスキルでコマンドを実行する際に必要となるすべての gcloud CLI、REST API、MCP に関する帰属表示の要件については、 Usage Attribution の手順に従ってください。

🛑 基本方針：結果を優先

1. 依頼されたタスクの特定：ユーザーがサービスの有効化、アクティベーション状態の確認、Monitoring Point（MP）のダウンロード／インストールやトラブルシューティング、AppNeta の監視ポリシーやアラームルールの設定、プロビジョニング済みのリソースやパスの確認、アラートポリシーの設定、Cloud Logging のアラームや Cloud Monitoring のメトリクスの照会のいずれを行おうとしているかを特定します。
2. 実行して提示：タスクを完了するため、または正確な手順を案内するために必要最小限のコマンドや API 呼び出しを実行します。
3. 確定した回答：状態や確認に関する問い合わせには、確定した状態（例：ACTIVE、ACTIVATING、パスの一覧）をすぐに報告します。

概要

Cloud Network Insights は、Broadcom AppNeta との連携により、Cross-Cloud Network のオブザーバビリティを実現する包括的な合成モニタリングを提供します。Google Cloud、オンプレミスのデータセンター、他のパブリッククラウド（AWS や Azure など）、パブリックインターネットにインストールされた Monitoring Point（MP）を使用して、ネットワークパスとウェブパスを監視します。

このスキルは、オンボーディング、サービスの有効化、Monitoring Point のデプロイ、ポリシーの作成、パスの確認を自動化します。

手順と CUJ

1. サービスの有効化とステータス

• API の有効化：

  gcloud services enable networkmanagement.googleapis.com --project=PROJECT_ID
  

• プロバイダーの作成（Google Cloud コンソールのデフォルトに合わせるには external を使用します。カスタムの PROVIDER_ID も指定できます）：

  gcloud network-management network-monitoring-providers create PROVIDER_ID \
    --provider-type=EXTERNAL \
    --location=global \
    --project=PROJECT_ID
  

  ⚠️ このコマンドが利用規約に未同意であるために失敗した場合は、Google Cloud コンソールのオンボーディングページをユーザーに案内します： https://console.cloud.google.com/net-intelligence/cloud-network-insights/onboarding?project=PROJECT_ID

• 状態の確認：

  gcloud network-management network-monitoring-providers \
    describe PROVIDER_ID \
    --location=global \
    --project=PROJECT_ID \
    --format=json
  

  .state が ACTIVE であることを確認します。（ACTIVATING はバックエンドが AppNeta リソースをプロビジョニング中であることを示します。）

• プロバイダーの削除（クリーンアップ）：

  gcloud network-management network-monitoring-providers delete PROVIDER_ID \
    --location=global \
    --project=PROJECT_ID
  

2. Monitoring Point のデプロイと確認

Cloud Network Insights は、7 種類の Monitoring Point デプロイタイプをサポートしています： container、helm、gce-vm、aws-ec2、azure-vm、vmware、kvm。

• プラットフォームの選択：デフォルトのデプロイタイプを決めつけないでください。続行する前に、ユーザーの対象環境を特定するか、ユーザーに確認してください。
• 手順とコマンド：必要なすべてのパラメーター、ダウンロードコマンド、デプロイマニフェスト、ステータス確認コマンド（monitoring-points list）については、 Monitoring Point Deployment Reference を参照してください。

3. モニタリングポリシーとアラームルールの設定（AppNeta）

モニタリングポリシーでは、モニタリングポイントが実行するアクティブな合成ネットワークテストとウェブテストを設定します。アラームルールでは、パスアラームを発生させるしきい値と評価時間枠を定義します。

• ポリシーの種類（/api/v4/monitoringPolicy）：
  • ネットワークモニタリングポリシー：TCP または UDP 経由で、対象 IP への（またはモニタリングポイント間の双方向の）パケット損失、レイテンシ、ジッターを監視します。
  • ウェブモニタリングポリシー：HTTP/HTTPS アプリケーションの合成チェック（ステータスコード 200 のアサーションを伴う GET リクエストなど）です。
• 作成前の確認：重複したリソースの作成や API の競合を避けるため、新しいポリシーを作成する前に必ず GET /api/v4/monitoringPolicy をクエリし、対象の名前を持つポリシーがすでに存在するか確認します。
• アラームルール（AppNeta Web UI のみ）：アラームルールは AppNeta Web UI の Alarms > Alarm Rules で設定します（Broadcom Alarm Rulesを参照）。REST API v4 ではサポートされていません。
• 手順とペイロード：認証トークンの生成、組織の検出、REST JSON ペイロードについては、モニタリングポリシー設定リファレンスを参照してください。

4. Google Cloud でプロビジョニング済みのパスを確認する

ポリシーを設定し、MP がオンラインになったら、プロビジョニング済みのパスを確認します。

• ネットワークパスを一覧表示する：

  gcloud network-management network-monitoring-providers network-paths list \
    --network-monitoring-provider=PROVIDER_ID \
    --location=global \
    --project=PROJECT_ID \
    --format=json
  

• ウェブパスを一覧表示する：

  gcloud network-management network-monitoring-providers web-paths list \
    --network-monitoring-provider=PROVIDER_ID \
    --location=global \
    --project=PROJECT_ID \
    --format=json
  

5. Cloud Network Insights のリソースと状態をクエリする

1. プロバイダー名を検出する：gcloud network-management network-monitoring-providers list --location=global --project=PROJECT_ID を実行して、プロバイダー ID（PROVIDER_ID）を取得します。Google Cloud コンソールから有効にした場合、プロバイダー ID は external になります。手動で作成した場合は、カスタム名になります。
2. 子リソースをクエリする：子リソースのコマンド（list や describe など）に --network-monitoring-provider=PROVIDER_ID と --location=global を渡します。
   • モニタリングポイント：gcloud network-management network-monitoring-providers monitoring-points [list|describe]
   • ネットワークパス：gcloud network-management network-monitoring-providers network-paths [list|describe]
   • ウェブパス：gcloud network-management network-monitoring-providers web-paths [list|describe]

6. アラートポリシー、Cloud Logging、Cloud Monitoring のメトリクス

• アラートポリシー（gcloud monitoring policies）：経路アラームや運用イベント用に、ログに一致するアラートポリシー（POLICY_FILE 内の conditionMatchedLog.filter と alertStrategy.notificationRateLimit を含む）を作成します（アラートと通知の設定を参照してください）。 insights_alarm ポリシーでは、ユーザーがノイズの多いアラームを含めるよう求めない限り、頻繁に発生するノイズやバーストノイズを除外するため、デフォルトで AND NOT jsonPayload.noise_conditions:* を含めてください。

  # JSON ファイルまたは YAML ファイルからアラートポリシーを作成
  gcloud monitoring policies create --project=PROJECT_ID \
    --policy-from-file=POLICY_FILE
  
  # アラートポリシーを削除（クリーンアップ用）
  gcloud monitoring policies delete POLICY_ID \
    --project=PROJECT_ID \
    --quiet
  

  Google Cloud コンソールのアラートテンプレートで使用する conditionMatchedLog.filter の値の例：

  • ネットワーク経路の停止／長時間のパケット損失／DNS エラー：

    resource.type = "networkmanagement.googleapis.com/NetworkPath" AND logName =~ "insights_alarm" AND (jsonPayload.alarm_severity = "MAJOR" OR jsonPayload.alarm_severity = "CRITICAL") AND jsonPayload.state = "RAISED" AND jsonPayload.alarm_type =~ "QUALITY_OF_SERVICE" AND jsonPayload.rule =~ "Outage" AND NOT jsonPayload.noise_conditions:*
    

    （必要に応じて、jsonPayload.rule =~ "Extended loss" または "Multiple DNS errors" に置き換え、alarm_severity = "MINOR" を指定してください。）

  • Web 経路で複数の Web エラーが発生：

    resource.type = "networkmanagement.googleapis.com/WebPath" AND logName =~ "insights_alarm" AND jsonPayload.alarm_severity = "MAJOR" AND jsonPayload.state = "RAISED" AND jsonPayload.alarm_type =~ "QUALITY_OF_SERVICE" AND jsonPayload.rule =~ "Multiple Web errors" AND NOT jsonPayload.noise_conditions:*
    

  • モニタリングポイントのオフラインおよびネットワーク経路の MTU 変更イベント：

    resource.type = "networkmanagement.googleapis.com/MonitoringPoint" AND logName =~ "insights_event" AND jsonPayload.event_type = "MONITORING_POINT_OFFLINE"
    

    resource.type = "networkmanagement.googleapis.com/NetworkPath" AND logName =~ "insights_event" AND jsonPayload.event_type = "MTU_CHANGE"
    

• Cloud Logging（gcloud logging read）：Cloud Logging にエクスポートされた経路アラーム（logName =~ "insights_alarm"）と運用ライフサイクルイベント（logName =~ "insights_event"）をクエリします（jsonPayload フィールドのスキーマとイベントタイプについては、ロギングの設定を参照してください）。アラームの状態遷移（RAISED、UPDATED、CLEARED）は、同じ jsonPayload.alarm_id を共有する個別のエントリとして記録されます。現在有効なアラームを判定するには、各 alarm_id の最新エントリが CLEARED に遷移していないことを確認してください。

• Cloud Monitoring（REST API projects.timeSeries.list）：resource.labels.path_id でフィルタリングした経路パフォーマンスメトリクス（NetworkPath および WebPath）を、Cloud Monitoring から GET "https://monitoring.googleapis.com/v3/projects/PROJECT_ID/timeSeries" を使ってクエリします。認証には Authorization: Bearer $(gcloud auth application-default print-access-token) を指定します（モニタリングメトリクスおよび ダッシュボードの表示を参照してください）。

7. デプロイの診断とトラブルシューティング

あらゆるプラットフォームで Monitoring Point のデプロイを診断するには、次の手順を実施します。

1. Google Cloud への登録：monitoring-points list（または describe）で connectionStatus が ONLINE であることを確認し、Monitoring Point が登録され、Cloud Network Insights に接続されていることを検証します。
2. モデル固有のワークロード、ホスト、アプライアンスの健全性：対象プラットフォームで、Monitoring Point のランタイム、コンテナ／Kubernetes ワークロード、または v35 Web Admin のステータスを確認します。モデル固有のトラブルシューティングガイドについては、 Monitoring Point のデプロイ リファレンス、 Broadcom の Monitoring Point トラブルシューティング、 および Cloud Network Insights のトラブルシューティングを参照してください。
3. ネットワーク、プロキシ、ファイアウォールのルール：対象環境のファイアウォール、Web プロキシ、カスタム CA 証明書、gRPC／SSL 検査のバイパス設定（data.na1.cni.appneta.com、content.na1.cni.appneta.com、comms.na1.cni.appneta.com、または Private Service Connect の .p. エンドポイント）を、 Broadcom のファイアウォール設定および Monitoring Point の追加に照らして確認します。

リファレンス ドキュメント

詳細なガイド、完全なペイロード、テンプレートについては、次を参照してください。

• Monitoring Point のデプロイ リファレンス： 7 つのプラットフォーム（コンテナ、Helm、GCE VM Terraform、AWS、Azure、VMware、KVM）すべてのデプロイガイドとコマンドリファレンスです。
• Monitoring Policy の設定リファレンス： ネットワークおよび Web の監視ポリシー JSON ペイロードと AppNeta API のワークフローです。
• Google Cloud Network Insights のドキュメント： Cloud Network Insights の設定、概念、操作に関する Google Cloud 公式ドキュメントです。
• Cloud Network Insights 向け Broadcom AppNeta のドキュメント： Broadcom AppNeta の Monitoring Point、パスパフォーマンス、API に関するガイドです。