このページでは、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 でアラームルールを作成する
パフォーマンスのしきい値を定義するアラームルールを作成します。
Google Cloud コンソールを開き、[ネットワーク インテリジェンス] > [Cloud Network Insights] > [アラート ポリシー] に移動します。
[Create Alarm Rules] をクリックして、AppNeta の [Alarm Rule Edit] ページを開きます。
指標、しきい値、違反戦略、重大度を指定するルールを定義します。デフォルトのルールを使用またはカスタマイズできます。
アラームがトリガーされると、アラームログが Cloud Logging に送信されます。ログが Google Cloudに送信されたら、Cloud Network Insights に移動してアラート ポリシーを設定できます。
アラームルールの作成の詳細については、AppNeta ドキュメントのアラームルールをご覧ください。
Google Cloudでログを表示する
Cloud Network Insights は、Cloud Logging に詳細なログをエクスポートします。これにより、ネットワーク パフォーマンスと重要なイベントの分析とトラブルシューティングを行うことができます。これらのログには、ログ エクスプローラを使用してアクセスできます。
Google Cloud コンソールで、[ログ エクスプローラ] ページに移動します。
関連情報に関するアラートを生成するクエリを作成する。
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/MonitoringPointnetworkmanagement.googleapis.com/NetworkPathnetworkmanagement.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 時間の頻度しきい値と短期バースト ウィンドウの両方に対して評価されます。 次のいずれかまたは両方の値を含めることができます。
アラームがノイズが多いと見なされない場合は、空の配列を返すか、完全に省略されます。 |
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_routeterminal_hop(ホップ オブジェクト): 最後に正常に到達したホップ(完了している場合は最終ホップ)。terminal_network(ネットワーク オブジェクト): ターミナルホップのネットワーク情報。
route_loopfirst_hop(ホップ オブジェクト): 検出されたルートループの最初のホップ。last_hop(ホップ オブジェクト): 検出されたルートループの最後のホップ。loop_span(int32): ループに含まれるホップ数。
target_ip_changeprevious_target_ip(文字列): 前回の traceroute で観測されたターゲット IP アドレス。new_target_ip(文字列): 現在のターゲット IP アドレス。
sequence_changelast_common_hop(ホップ オブジェクト): 前回の traceroute と今回の traceroute の間で共通する最後のホップ。previous_next_hop(ホップ オブジェクト): シーケンス内の前のネクストホップ デバイス。new_next_hop(ホップ オブジェクト): シーケンス内の新しいネクストホップ デバイス。previous_hop_count(int32): 前回の traceroute のホップの合計数。hop_count(int32): 現在の traceroute のホップの合計数。
network_changeprevious_asns(int32 の配列): パスの ASN ネットワークのシーケンス。new_asns(int32 の配列): パスの ASN ネットワークの新しいシーケンス。
isp_changeprevious_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 |
文字列 | モニタリング ポイントのホストのオペレーティング システム。 |