Loggly 告警集成

Loggly 是 SolarWinds 旗下的日志管理服务，其告警功能（Alerts）在保存的搜索命中数达到阈值时通知您。本集成通过 Loggly 的 HTTP Endpoints 通知方式，把每条 Loggly 告警转成一条 Flashduty 告警。

Loggly 的告警功能仅在付费套餐（Standard、Pro）中提供；免费的 Lite 套餐没有告警功能。30 天试用无需信用卡，试用期内可以正常使用告警。

在 Loggly 中配置

在 Loggly 中创建告警并添加 HTTP Endpoint

操作路径：Loggly › Alerts › Alerts List › Add New（编辑已有告警：Alerts › Alerts List › 该告警）

字段	填写
Name（必填）	自定义告警名称
Search（必填）	选择一个 Saved Search
Alert if（必填）	命中数条件，例如超过阈值
Check for this condition every（必填）	检查周期，下一步的超时时长参考它设置
Then（必填）	选择通知方式 HTTP Endpoints
URL（必填）	`{integration_url}`，地址中需包含 `integration_key`
Method（必填）	POST（Loggly 同时支持 POST 和 GET，Flashduty 的推送接口只接受 POST）
Enable this alert（可选）	保持勾选，取消勾选会停用但保留该告警

也可以在 Alert Endpoints 页面单独创建 HTTP Endpoint 后在告警中选用；需要同时通知多个目的地时使用 Add Multiple Endpoints。Loggly 会以固定结构的 JSON 对象推送，字段无法自定义：

{
  "alert_name": "IndexOutOfBounds Exception",
  "edit_alert_link": "https://<您的子域名>.loggly.com/alerts/edit/8188",
  "source_group": "N/A",
  "start_time": "Mar 17 11:41:40",
  "end_time": "Mar 17 11:46:40",
  "search_link": "https://<您的子域名>.loggly.com/search/?terms=...",
  "query": "*",
  "num_hits": 225,
  "recent_hits": [],
  "owner_username": "sample",
  "owner_subdomain": "sample",
  "owner_email": "you@example.com"
}

保存后确认该 HTTP Endpoint 已在这条告警的通知列表中启用。

在 Flashduty 协作空间开启超时自动关闭

操作路径：Flashduty 控制台 › 协作空间 › 配置 › 设置 › 高级配置Loggly 的 HTTP Endpoints 通知没有恢复事件：只要告警条件仍然成立，Loggly 就会按检查周期反复推送同一条告警（例如每分钟检查一次，条件持续 30 分钟就会推送 30 次）；条件消失后 Loggly 不再推送，也不会告诉 Flashduty “已恢复”。

字段	填写
超时自动关闭（必填）	在接收这些告警的协作空间中开启，详见超时自动关闭
超时时长（必填）	参考该保存搜索的检查周期，至少覆盖 2-3 个检查周期（例如检查周期 1 分钟，建议 30 分钟；检查周期 1 小时，建议 3 小时）
超时计时起点（必填）	故障触发

让保存的搜索命中一次并确认

操作路径：Loggly › Alerts › Alerts List请让保存的搜索在真实环境中命中一次（例如临时降低阈值，或触发一条会被该搜索命中的日志），确认 Flashduty 收到对应告警，集成显示 最新事件时间，再把阈值改回正常值。

Alert Key

Flashduty 使用「Loggly 账号子域名（owner_subdomain）+ 告警定义 ID」的组合作为 Alert Key。告警定义 ID 从 edit_alert_link（该告警的编辑页面地址）中解析，即 URL 中 /alerts/edit/ 后面的数字，例如 .../alerts/edit/8188 中的 8188。 edit_alert_link 缺失，或不是 /alerts/edit/<数字ID> 形式的地址时，Flashduty 会拒绝该请求。同一条告警定义在条件持续期间反复推送的多次通知，会合并到同一条 Flashduty 告警里，而不是各自开出新告警；告警名称、命中数、时间范围、查询语句等字段的变化不影响 Alert Key。

状态和告警等级

Loggly 的 HTTP Endpoints 通知不携带严重程度字段，所有告警都以 Warning 等级触发。日志搜索命中数超过阈值本身不代表故障，如果某条保存搜索确实需要更高优先级，可在 Flashduty 的告警规则中调整。

标签	来源
`check`	告警名称（`alert_name`）
`resource` / `source_group`	保存搜索所属的 Source Group，未分组时为 `N/A`
`alert_definition_id`	从 `edit_alert_link` 解析出的告警定义 ID，即 Alert Key 的一部分
`edit_alert_link`	该告警的编辑页面地址
`owner_username` / `owner_subdomain`	触发该告警的 Loggly 账号
`start_time` / `end_time`	本次检查窗口的起止时间
`query`	保存搜索使用的查询语句
`search_link`	本次命中结果的搜索页面地址
`num_hits`	本次检查窗口内命中的日志条数

常见问题

为什么配置了 HTTP Endpoint，却没有收到任何告警？

先确认账号是付费套餐（Standard/Pro）或仍在 30 天试用期内 —— 免费 Lite 套餐没有告警功能。再确认这条告警的通知方式里已经勾选/启用了刚创建的 HTTP Endpoint，并且保存搜索确实命中了数据。

告警为什么一直不关闭？

Loggly 的通用 HTTP Endpoints 没有恢复事件，条件消失后 Loggly 只是停止推送，不会主动通知”已恢复”。请开启协作空间的超时自动关闭，或在 Flashduty 中手动关闭该告警。

同一条告警短时间内收到很多条推送，正常吗？

正常。只要保存搜索的条件持续成立，Loggly 就会按检查周期反复推送；Flashduty 会把这些推送合并到同一条告警上，不会重复开出新告警。

能否自定义推送内容？

不能。HTTP Endpoints 的 JSON 结构由 Loggly 固定，不支持修改字段。如果需要转发到 PagerDuty、Slack、OpsGenie 等其他平台，Loggly 另外提供了专用的原生集成，但不经过本集成。

更多字段含义请参阅 Loggly Alert Endpoints 和 Loggly Alerts。

快速开始

产品对比

协作空间

故障管理

故障复盘

状态页

分析看板

集成配置

配置中心

高级功能

集成中心

最佳实践

在 Flashduty On-call

使用专属集成

使用共享集成

在 Loggly 中配置

Alert Key

状态和告警等级

标签

常见问题