ロギングの設定

このページでは、Cloud Network Insights が AppNeta と統合してアラームを生成する方法と、これらのアラームが分析、表示、アラート ポリシーの作成のために Google Cloud に送信される方法について説明します。

ロギングとアラートのタスクは、 Google Cloud と AppNeta の間で分割されます。Cloud Network Insights のロギングは、モニタリング ポイントによって収集された指標が、AppNeta のアラームルールで構成したしきい値に違反したときに追跡します。

AppNeta でアラームとアラームルールを作成して、アラームログを生成します。アラームログとイベントログは Cloud Logging にエクスポートされます。アラート ポリシーを使用すると、ネットワーク インシデントが発生したときにアラートと通知を送信できます。

始める前に

アラームルールを作成する前に、モニタリング ポイントをデプロイする必要があります。

AppNeta のアラーム

アラームとアラームルールは AppNeta で作成されます。アラームは、ネットワークに問題があることを知らせます。追跡する指標(レイテンシなど)が特定の期間内に設定されたしきい値を超えると、アラームルール違反になります。1 回の違反後にアラームをトリガーするか、設定された間隔で複数回の違反後にアラームをトリガーするかを選択できます。

たとえば、レイテンシが 3 分以内に 2 回 160 ミリ秒を超えた場合に、アラームが警告をトリガーするように設定できます。このアラームはログとして Google Cloud に送信されます。ログが Cloud Logging に到着すると、アラートを送信してチームに通知できます。

アラームの詳細については、AppNeta ドキュメントのアラームの概要またはアラーム - ベスト プラクティスをご覧ください。

AppNeta でアラームルールを作成する

パフォーマンスのしきい値を定義するアラームルールを作成します。

  1. Google Cloud コンソールを開き、[ネットワーク インテリジェンス] > [Cloud Network Insights] > [アラート ポリシー] に移動します。

    [アラート ポリシー] に移動

  2. [Create Alarm Rules] をクリックして、AppNeta の [Alarm Rule Edit] ページを開きます。

  3. 指標、しきい値、違反戦略、重大度を指定するルールを定義します。デフォルトのルールを使用またはカスタマイズできます。

アラームがトリガーされると、アラームログが Cloud Logging に送信されます。ログが Google Cloudに送信されたら、Cloud Network Insights に移動してアラート ポリシーを設定できます。

アラームルールの作成の詳細については、AppNeta ドキュメントのアラームルールをご覧ください。

Google Cloudでログを表示する

Cloud Network Insights は、Cloud Logging に詳細なログをエクスポートします。これにより、ネットワーク パフォーマンスと重要なイベントの分析とトラブルシューティングを行うことができます。これらのログには、ログ エクスプローラを使用してアクセスできます。

  1. Google Cloud コンソールで、[ログ エクスプローラ] ページに移動します。

    [ログ エクスプローラ] に移動

  2. 関連情報に関するアラートを生成するクエリを作成する。

Cloud Network Insights のログでは、次のいずれかのログ ID が使用されます。

  • アラームログ: networkmanagement.googleapis.com/insights_alarm
  • イベントログ: networkmanagement.googleapis.com/insights_event

詳細については、Logging のクエリ言語を使用してクエリを作成して保存するをご覧ください。

料金

Cloud Network Insights のログはすべて Cloud Logging に書き込まれます。このサービスに対して Cloud Network Insights から別途料金が請求されることはありません。ただし、書き込まれて保存されるログのサイズによっては、追加のストレージ コストが発生する可能性があります。

Cloud Logging の料金については、Google Cloud Observability の料金: Cloud Logging をご覧ください。

ログの詳細

各ログタイプの具体的な詳細は jsonPayload フィールドに含まれていますが、ログのクエリと理解には、他のいくつかの標準 LogEntry フィールドが重要です。

アラームログ

  • ログ ID: networkmanagement.googleapis.com/insights_alarm
  • トリガー済み: アラームルールの条件が満たされたときに生成されます。
  • リソースラベル: ログに関連付けられているモニタリング対象リソースを記述します。以下のような分析を行えます。
    • type - リソースのタイプ。次のいずれかになります。
      • networkmanagement.googleapis.com/MonitoringPoint
      • networkmanagement.googleapis.com/NetworkPath
      • networkmanagement.googleapis.com/WebPath
    • labels - 特定のリソース インスタンスを識別する Key-Value ペア(resource_container(プロジェクト ID)、location、network_monitoring_provider_id、path_id、monitoring_point_id など)。
  • 主要な JSON フィールド: アラームログには、トリガーされたアラームに関する情報が記録されます。
  • 重大度のマッピング: 重大度は、AppNeta と Google Cloudで異なる方法で記録されます。
    AppNeta の重大度 Google Cloud ログの重大度
    重大 重大
    重大 エラー
    軽微 警告
    警告 通知

アラームログのフィールド

アラームログの jsonPayload には、次のフィールドが含まれます。

フィールド 型 説明
alarm_id 文字列 AppNeta のアラームの固有識別子。
alarm_severity enum アラームの重大度。CRITICAL、MAJOR、MINOR、WARNING のいずれかになります。
alarm_type enum アラームのタイプ。QUALITY_OF_SERVICE タイプがサポートされています。
cleared_reason 文字列 アラームがクリアされた理由。state = "CLEARED" の場合にのみ生成されます(それ以外の場合は省略されるか null になります)。一般的な文字列値には、alarm-rule-no-longer-violated、stale、rule-deleted、duplicate などがあります。
cleared_time timestamp アラームがクリアされた時刻。アラームログの状態が RAISED または UPDATED の場合、これは空になります。
description 文字列 アラームの説明(人が読める形式)。
first_violation_time timestamp アラーム条件が最初に違反された時刻。
item オブジェクト アラームに関連付けられているエンティティ。詳細については、一般的なアイテム構造をご覧ください。
noise_conditions array of strings 指定されたルールとアイテムのペアに対して、このアラームをフラグ付けしたノイズフィルタ条件を識別します。アラームは、24 時間の頻度しきい値と短期バースト ウィンドウの両方に対して評価されます。

次のいずれかまたは両方の値を含めることができます。

  • frequent-detection: 同じアイテムでアラームの発生が 24 時間のしきい値(デフォルト: 5 件のアラーム)に達したときにトリガーされます。
  • burst-detection: 構成された時間枠内に複数のアラームが発生した場合にトリガーされます(デフォルト: 60 分間に 1 つ以上のアラーム)。

アラームがノイズが多いと見なされない場合は、空の配列を返すか、完全に省略されます。

provider_link 文字列 AppNeta UI のアラームへのハイパーリンク。
raised_time timestamp アラームが発生した時刻。
receiveTimestamp 文字列 アラームが作成された時刻( Google Cloud)。
rule 文字列 アラームをトリガーしたアラームルールの名前。
state enum アラームの状態。RAISED、UPDATED(アラームの詳細は AppNeta で更新されていますが、まだクリアされていません)、CLEARED のいずれかになります。
timestamp 文字列 AppNeta でアラームが作成された時刻。

イベントログ

  • ログ ID: networkmanagement.googleapis.com/insights_event
  • トリガー: 構造的な変更(Route Change、MTU Change、Monitoring Point Offline など)が発生したときに生成されます。
  • 重大度: 常に INFO。
  • 主要な JSON フィールド: イベントログには、トリガーされたイベントに関する情報が含まれます。

イベントログのフィールド

イベントログの jsonPayload には、次のフィールドが含まれます。

フィールド 型 説明
event_detail オブジェクト イベントの種類に固有の詳細情報。値は route_change_event、mtu_change_event、qos_change_event、forwarding_loss_clear_event のいずれかです。詳細情報がないイベントの場合は、空のオブジェクトが返されます。詳細については、イベントの詳細フィールドをご覧ください。
event_id 文字列 このイベントの固有識別子。
event_type enum イベントのタイプ。MONITORING_POINT_OFFLINE、MONITORING_POINT_ONLINE、ROUTE_CHANGE、MTU_CHANGE、QOS_CHANGE、FORWARDING_LOSS_CLEAR のいずれかです。
item オブジェクト イベントに関連付けられているエンティティ。詳しくは、一般的なアイテム構造をご覧ください。
receiveTimestamp 文字列 イベントが Google Cloudで作成された時刻。
timestamp 文字列 AppNeta でイベントが作成された時刻。

イベントの詳細フィールド

event_detail オブジェクトには、イベントタイプに固有の詳細が含まれます。event_type に応じて、次のいずれかのネストされたオブジェクトが含まれます。

詳細情報がないイベントの場合は、空のオブジェクトが返されます。

MTU 変更イベント(mtu_change_event)

このオブジェクトは、MTU サイズが変更されるたびに詳細をキャプチャします。

フィールド タイプ 説明
new_mtu int32 新しく測定された MTU。
previous_mtu int32 以前の MTU(存在する場合、起動時に省略)。
mtu_exceeded ホップ オブジェクト パケットが大きすぎるエラーを報告するノードの詳細(IP アドレスなど)を含むホップ。詳細については、ホップをご覧ください。

QoS 変更イベント(qos_change_event)

このオブジェクトは、検出されたすべてのパスの QoS 再マッピングを報告します。

フィールド タイプ 説明
configured_qos int32 ジョブ設定で構成された QoS。
remapped_qos int32 パスで変更された QoS が検出されました。
ip_address 文字列 QoS の変更が検出されたホップの IP アドレス(判明している場合)。

転送損失クリア イベント(forwarding_loss_clear_event)

このオブジェクトは、特定のネットワーク ホップ(転送ロス)から始まる持続的なパケットロスが解消され、通常の転送が再開されたことを報告します。このイベントは、通常の転送が再開されたときと、最初の疑わしいタイムスタンプをキャプチャします。転送損失の発生は、AppNeta アラームを使用してモニタリングされます。

フィールド タイプ 説明
protocol 文字列 モニタリング プロトコル(TCP、UDP、ICMP など)。
first_hop ホップ オブジェクト 転送損失が始まった最初のホップ。詳しくは、ホップをご覧ください。
initial_loss_suspected_time timestamp 転送損失が最初に疑われた時刻。

ルート変更イベント(route_change_event)

このオブジェクトは、連続する traceroute 間のホップ数または既知の IP アドレスのシーケンスの違いをキャプチャします。

フィールド タイプ 説明
previous_route_change_time timestamp 以前のルートを最初に検出した traceroute のタイムスタンプ。
protocol 文字列 traceroute に使用されるプロトコル(TCP、UDP、ICMP など)。
hop_count int32 ルート内のホップの合計数。
target_ip 文字列 traceroute のターゲット IP アドレス。
route_changes オブジェクトの配列 検出されたすべての変更の配列。各オブジェクトには、route_change_type 文字列と details オブジェクトが含まれています。ルート変更の詳細をご覧ください。

ルート変更の詳細

route_changes 配列内の details オブジェクトは、route_change_type によって異なります。

  • incomplete_route または complete_route
    • terminal_hop(ホップ オブジェクト): 最後に正常に到達したホップ(完了している場合は最終ホップ)。
    • terminal_network(ネットワーク オブジェクト): ターミナルホップのネットワーク情報。
  • route_loop
    • first_hop(ホップ オブジェクト): 検出されたルートループの最初のホップ。
    • last_hop(ホップ オブジェクト): 検出されたルートループの最後のホップ。
    • loop_span(int32): ループに含まれるホップ数。
  • target_ip_change
    • previous_target_ip(文字列): 前回の traceroute で観測されたターゲット IP アドレス。
    • new_target_ip(文字列): 現在のターゲット IP アドレス。
  • sequence_change
    • last_common_hop(ホップ オブジェクト): 前回の traceroute と今回の traceroute の間で共通する最後のホップ。
    • previous_next_hop(ホップ オブジェクト): シーケンス内の前のネクストホップ デバイス。
    • new_next_hop(ホップ オブジェクト): シーケンス内の新しいネクストホップ デバイス。
    • previous_hop_count(int32): 前回の traceroute のホップの合計数。
    • hop_count(int32): 現在の traceroute のホップの合計数。
  • network_change
    • previous_asns(int32 の配列): パスの ASN ネットワークのシーケンス。
    • new_asns(int32 の配列): パスの ASN ネットワークの新しいシーケンス。
  • isp_change
    • previous_isp(ネットワーク オブジェクト): 前の traceroute で確認された ISP。
    • new_isp(ネットワーク オブジェクト): 観測された現在の ISP。

共通のサブオブジェクト

ホップ オブジェクトとネットワーク オブジェクトは、複数のフィールドに対して返されます。

ホップ

ホップ オブジェクトは、特定のネットワーク ホップを記述します。

フィールド タイプ 説明
hop_number int32 traceroute のホップ番号。
ip_address 文字列 ホップの IP アドレス。
hostname 文字列 ホップの IP アドレスに解決されたホスト名。

ネットワーク

ネットワーク オブジェクトは、アクションが発生したネットワークを記述します。

フィールド タイプ 説明
asn int32 ネットワークの自律システム番号(ASN)。
display_name 文字列 ネットワークの名前(ISP 名や組織名など)。

一般的なアイテム構造

アラームログとイベントログの両方の jsonPayload 内の item フィールドには、関連するエンティティの詳細が含まれます。構造は商品アイテム タイプによって異なります。

NetworkPathItem

フィールド 型 説明
destination 文字列 宛先 IP アドレスまたはホスト名。
destination_monitoring_point MonitoringPointItem 宛先 MonitoringPointItem の詳細(MonitoringPoint-to-MonitoringPoint パスのみ)。
display_name 文字列 ネットワーク パスのユーザー定義の表示名。
monitoring_policy_display_name 文字列 モニタリング ポリシーの表示名。
monitoring_policy_id 文字列 モニタリング ポリシーの ID。
network_protocol 文字列 使用されるネットワーク プロトコル(TCP、UDP、ICMP など)。
provider_tags オブジェクトの配列 AppNeta でパスに定義されているタグ。
source_monitoring_point MonitoringPointItem ソース MonitoringPointItem の詳細。

WebPathItem

フィールド 型 説明
destination 文字列 リンク先 URL。
display_name 文字列 ウェブパスのユーザー定義の表示名。
monitoring_policy_display_name 文字列 モニタリング ポリシーの表示名。
monitoring_policy_id 文字列 モニタリング ポリシーの ID。
provider_tags 配列 パスのプロバイダで定義されているタグ。
source_monitoring_point オブジェクト ソース MonitoringPoint の詳細。

MonitoringPointItem

フィールド 型 説明
display_name 文字列 モニタリング ポイントのユーザー定義の表示名。
host オブジェクト モニタリング ポイントのホストの詳細。
id 文字列 モニタリング ポイントの固有識別子。
provider_tags 配列 モニタリング ポイントのプロバイダで定義されたタグ。

MonitoringPointHost

フィールド 型 説明
cloud_instance_id 文字列 クラウド プロバイダのインスタンス ID。
cloud_project_id 文字列 Google Cloud プロジェクト ID
cloud_provider 文字列 クラウド プロバイダ(GCP、AWS、AZURE など)。
cloud_region 文字列 エンドポイントのクラウド リージョン(例: us-central1)。
cloud_virtual_network_ids array of strings ユーザーに表示されるクラウド仮想ネットワーク ID。
cloud_zone 文字列 エンドポイントのクラウドゾーン(例: us-central1-a)。
labels 地図 VM インスタンスに構成されているユーザー定義のラベル。
os 文字列 モニタリング ポイントのホストのオペレーティング システム。