このページでは、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] > [アラート ポリシー] に移動します。
[アラームルールの作成] をクリックして、AppNeta の [アラームルールの編集] ページを開きます。
指標、しきい値、違反戦略、重大度を指定するルールを定義します。デフォルトのルールを使用することも、カスタマイズすることもできます。
アラームがトリガーされると、アラームログが Cloud Logging に送信されます。ログが Google Cloudに送信されたら、Cloud Network Insights に移動してアラート ポリシーを設定できます。
アラームルールの作成の詳細については、AppNeta ドキュメントのアラームルールをご覧ください。
Google Cloudでログを表示する
Cloud Network Insights は、Cloud Logging に詳細なログをエクスポートして、ネットワーク パフォーマンスと重要なイベントの分析とトラブルシューティングに役立てます。これらのログには、ログ エクスプローラを使用してアクセスできます。
Google Cloud コンソールで、[ログ エクスプローラ] ページに移動します。
関連情報に関するアラートを生成するクエリを作成します。
Cloud Network Insights ログでは、logName に次のいずれかが使用されます。
- アラームログ -
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 フィールドも重要です。
アラームログ
- ログ名:
networkmanagement.googleapis.com/insights_alarm - トリガー: アラームルールの条件が満たされたときに生成されます。
- リソースラベル: ログに関連付けられているモニタリング対象リソースについて説明します。これには以下が含まれます。
type- リソースのタイプ。次のいずれかになります。networkmanagement.googleapis.com/NetworkMonitoringProvidernetworkmanagement.googleapis.com/MonitoringPointnetworkmanagement.googleapis.com/NetworkPath
labels- 特定のリソース インスタンスを識別するキーと値のペア（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_time |
timestamp | アラームがクリアされた時刻。アラームログの状態が RAISED または UPDATED の場合、これは空になります。 |
description |
文字列 | アラームの説明（人が読める形式）。 |
first_violation_time |
timestamp | アラーム条件が最初に違反された時刻。 |
item |
オブジェクト | アラームに関連付けられているエンティティ。詳しくは、一般的なアイテム構造をご覧ください。 |
provider_link |
文字列 | AppNeta UI のアラームへのハイパーリンク。 |
raised_time |
timestamp | アラームが発生した時刻。 |
receiveTimestamp |
文字列 | アラームが作成された時刻（ Google Cloud）。 |
rule |
文字列 | アラームをトリガーしたアラームルールの名前。 |
state |
enum | アラームの状態。RAISED、UPDATED（アラームの詳細は AppNeta で更新されたが、まだクリアされていない）、CLEARED のいずれかになります。 |
timestamp |
文字列 | AppNeta でアラームが作成された時刻。 |
イベントログ
- ログ名:
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 です。詳細情報のないイベントについては、空のオブジェクトが返されます。 |
event_id |
文字列 | このイベントの一意の識別子。 |
event_type |
enum | イベントのタイプ。MONITORING_POINT_OFFLINE、MONITORING_POINT_ONLINE、ROUTE_CHANGE、MTU_CHANGE、または QOS_CHANGE のいずれかです。 |
item |
オブジェクト | イベントに関連付けられているエンティティ。詳しくは、一般的なアイテム構造をご覧ください。 |
receiveTimestamp |
文字列 | イベントが作成された時刻（ Google Cloud）。 |
timestamp |
文字列 | AppNeta でイベントが作成された時刻。 |
一般的なアイテム構造
アラームログとイベントログの両方の jsonPayload 内の item フィールドには、関連付けられたエンティティの詳細が含まれています。構造は商品アイテム タイプによって異なります。
NetworkPathItem
| フィールド | 型 | 説明 |
|---|---|---|
destination |
文字列 | 宛先 IP アドレスまたはホスト名。 |
destination_monitoring_point |
MonitoringPointItem | 移行先 MonitoringPointItem の詳細（MonitoringPoint から 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 |
文字列 | モニタリング ポイントのホストのオペレーティング システム。 |