vshn/signalilo

Signalilo

镜像概述和主要用途

Signalilo是Alertmanager到Icinga2的桥接实现，通过webhook接收来自Alertmanager的告警，并使用go-icinga2-client将这些告警转发至Icinga2，实现监控告警的跨平台集成与管理。

核心功能和特性

• 作为Alertmanager与Icinga2之间的桥梁，接收webhook告警并转发
• 提供健康检查端点/healthz，监控服务运行状态
• 支持通过命令行选项或环境变量进行灵活配置
• 具备告警垃圾回收机制，自动清理已恢复的Icinga服务对象
• 支持向Icinga发送心跳信号，确保服务可用性
• 将Alertmanager的标签和注解映射为Icinga的自定义变量，支持类型转换

使用场景和适用范围

适用于需要将Prometheus/Alertmanager监控系统与Icinga2告警平台集成的场景，特别适合需要集中管理不同监控系统告警的企业级环境。

安装与使用方法

安装方式

Helm

bash
helm install --name signalilo appuio/signalilo

详细信息参见https://github.com/appuio/charts/tree/master/signalilo%E3%80%82

Docker

bash
docker run --name signalilo vshn/signalilo

OpenShift

Helm chart可直接在OpenShift环境中使用。

运行与端点

启动后，Signalilo监听以下HTTP路径：

• /webhook: 接收Alertmanager告警的端点
• /healthz: 返回HTTP 200状态码和ok payload，指示webhook服务正常运行

使用signalilo --help可查看所有可用配置参数。

配置说明

必选配置参数

可选配置参数

与Prometheus/Alertmanager集成

Alertmanager配置

/webhook端点接收符合Alertmanager webhook格式的告警。以下是OpenShift上Signalilo安装的Alertmanager配置示例：

yaml
global:
  resolve_timeout: 5m
route:
  group_wait: 30s
  group_interval: 5m
  repeat_interval: 12h
  receiver: default
  routes:
  - match:
      alertname: DeadMansSwitch
    repeat_interval: 5m
    receiver: deadmansswitch
receivers:
- name: default
  webhook_configs:
  - send_resolved: true
    http_config:
      bearer_token: "**"
    url: http://signalilo.appuio-monitoring/webhook
- name: deadmansswitch

告警要求

Signalilo需要告警包含以下信息：

必选标签

• severity: 必须为WARNING或CRITICAL
• alertname: 映射为display_name

必选注解

• description: 映射为notes
• message: 映射为plugin_output（可通过--alertmanager_pluginoutput_annotations修改注解名称）

可选注解

• runbook_url: 映射为notes_url

推断字段

• generatorURL: 映射为action_url

与Icinga集成

垃圾回收

Icinga中的服务对象会定期按以下规则进行垃圾回收（删除）：

• 服务对象处于OK状态
• 上次转为OK状态的时间超过keep_for配置
• 应用的UUID与vars.bridge_uuid匹配

垃圾回收所需的所有状态存储在Icinga服务变量中。

Signalilo心跳

启动时，Signalilo检查Icinga中是否存在匹配的心跳服务，若不存在则以fatal错误退出。运行期间，Signalilo定期向心跳服务发送状态。若未提供状态更新，Icinga会自动将检查标记为UNKNOWN。服务对象的配置方式参见Icinga2被动检查。

自定义变量

所有标签和注解会映射为自定义变量：

• 标签键前缀为label_
• 注解键前缀为annotation_

若标签或注解的键以icinga_开头，也会作为自定义变量添加（无前缀）。由于标签和注解的值均为字符串，需通过前缀提供类型信息（icinga_<type>_），当前支持类型：number和string。

示例：

• foo -> label_foo或annotation_foo
• icinga_foo_string -> 名为foo的标签/注解，值保持原样
• icinga_bar_number -> 名为bar的标签/注解，值转换为整数

若标签和注解同时存在icinga_<type>前缀，注解的值优先。

心跳服务

Signalilo支持在Icinga中创建心跳服务，可用于映射如prometheus-operator提供的DeadMansSwitch告警（指示整个Prometheus堆栈健康）。

要将告警视为心跳，告警必须包含标签heartbeat，其值需解析为Go duration。解析成功后，Signalilo会创建启用主动检查的Icinga服务检查，检查间隔设为解析的时长加10%（用于应对网络延迟等，避免心跳检查波动）。