本页面介绍了 Cloud Network Insights 如何与 AppNeta 集成以生成警报,以及如何将这些警报发送到 Google Cloud 以进行分析、查看和创建提醒政策。
日志记录和提醒任务由 Google Cloud 和 AppNeta 分担。当监控点收集的指标违反您在 AppNeta 中使用警报规则配置的阈值时,Cloud Network Insights 日志记录会进行跟踪。
在 AppNeta 中创建警报和警报规则,以生成警报日志。然后,系统会将警报日志和事件日志导出到 Cloud Logging。然后,您可以使用提醒政策在发生网络突发事件时发送提醒和通知。
准备工作
您必须先部署监控点,然后才能创建警报规则。
AppNeta 中的警报
警报和警报规则在 AppNeta 中创建。当网络出现问题时, 警报会通知您。如果您跟踪的指标(例如延迟时间)在特定时间间隔内超过了设定的阈值,则表示违反了警报规则。您可以选择在发生单次违规后触发警报,也可以选择在设定的时间间隔内发生多次违规后触发警报。
例如,如果延迟时间在 3 分钟内两次超过 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 中导出详细日志,以帮助您分析和排查网络性能问题和重大事件。您可以使用 Logs Explorer 访问这些日志。
在 Google Cloud 控制台中,前往 Logs Explorer 页面。
创建查询,以便在出现相关信息时发出提醒。
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- 标识特定资源实例的键值对,例如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 |
枚举 | 警报的严重程度。可以是 CRITICAL、MAJOR、MINOR 或 WARNING。 |
alarm_type |
枚举 | 闹钟类型。支持 QUALITY_OF_SERVICE 类型。 |
cleared_reason |
字符串 | 清除警报的原因。仅当 state =“CLEARED”时生成(否则省略或为 null)。常见的字符串值包括 alarm-rule-no-longer-violated、stale、rule-deleted 和 duplicate。 |
cleared_time |
时间戳 | 清除警报的时间。如果警报日志的状态为 RAISED 或 UPDATED,则此字段为空。 |
description |
字符串 | 闹钟的人类可读说明。 |
first_violation_time |
时间戳 | 首次违反警报条件的时间。 |
item |
对象 | 与警报关联的实体。如需了解详情,请参阅常见商品结构。 |
noise_conditions |
字符串数组 | 标识哪些噪声过滤条件针对给定的规则和项对标记了此警报。系统会根据 24 小时频率阈值和短期突发窗口来评估警报。
可以包含以下一个或两个值:
如果警报不被视为嘈杂,则返回空数组或完全省略。 |
provider_link |
字符串 | AppNeta 界面中指向警报的超链接。 |
raised_time |
时间戳 | 警报发出时间。 |
receiveTimestamp |
字符串 | 在 Google Cloud中创建闹钟的时间。 |
rule |
字符串 | 触发警报的警报规则的名称。 |
state |
枚举 | 闹钟的状态。可以是 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 |
枚举 | 事件的类型。可以是 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 地址)的跃点。如需了解详情,请参阅 Hop。 |
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 |
跃点对象 | 开始发生转发丢失的第一跃点。如需了解详情,请参阅 Hop。 |
initial_loss_suspected_time |
时间戳 | 最初怀疑发生转发丢失的时间。 |
路线变更事件 (route_change_event)
该对象会捕获连续 traceroute 之间已知 IP 地址的跃点数或序列差异。
| 字段 | 类型 | 说明 |
|---|---|---|
previous_route_change_time |
时间戳 | 首次检测到上一个路由的 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 之间的最后一个公共跃点。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 到 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 |
字符串 | 目标网址。 |
display_name |
字符串 | 用户定义的 Web 路径显示名称。 |
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 |
字符串数组 | 用户可见的 Cloud 虚拟网络 ID。 |
cloud_zone |
字符串 | 端点的云可用区,例如 us-central1-a。 |
labels |
地图 | 在虚拟机实例上配置的用户定义的标签。 |
os |
字符串 | 监控点主机的操作系统。 |