设置日志记录

本页面介绍了 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 中创建警报规则

创建定义性能阈值的警报规则。

  1. 打开 Google Cloud 控制台,然后依次前往网络智能 > Cloud Network Insights > 提醒政策。

    前往“提醒政策”

  2. 点击创建警报规则,在 AppNeta 中打开警报规则修改页面。

  3. 定义规则,指定指标、阈值、违规策略和严重级别。您可以使用或自定义默认规则。

触发警报后,警报日志会发送到 Cloud Logging。将日志发送到 Google Cloud后,您可以前往 Cloud Network Insights 并设置提醒政策。

如需详细了解如何创建警报规则,请参阅 AppNeta 文档中的警报规则。

在 Google Cloud中查看日志

Cloud Network Insights 会在 Cloud Logging 中导出详细日志,以帮助您分析和排查网络性能问题和重大事件。您可以使用 Logs Explorer 访问这些日志。

  1. 在 Google Cloud 控制台中,前往 Logs Explorer 页面。

    转到日志浏览器

  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 - 标识特定资源实例的键值对,例如 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 小时频率阈值和短期突发窗口来评估警报。

可以包含以下一个或两个值:

  • frequent-detection:当同一项的警报发生次数达到 24 小时阈值(默认:5 次警报)时触发。
  • burst-detection:在配置的时间范围内发生多个警报时触发(默认:每 60 分钟超过 1 个警报)。

如果警报不被视为嘈杂,则返回空数组或完全省略。

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_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 之间的最后一个公共跃点。
    • 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 到 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 字符串 监控点主机的操作系统。