PagerDuty Exporter

![license]([] ![DockerHub]([] ![Quay.io]([***]

用于PagerDuty信息（用户、团队、排班、值班、事件等）的Prometheus exporter。

配置

Usage:
  pagerduty-exporter [OPTIONS]

应用选项:
      --debug                                 debug模式 [$DEBUG]
  -v, --verbose                               详细模式 [$VERBOSE]
      --log.json                              切换日志输出为json格式 [$LOG_JSON]
      --pagerduty.authtoken=                  PagerDuty认证令牌 [$PAGERDUTY_AUTH_TOKEN]
      --pagerduty.schedule.override-duration= 获取排班覆盖的PagerDuty时间范围（time.Duration）（默认：48h）[$PAGERDUTY_SCHEDULE_OVERRIDE_TIMEFRAME]
      --pagerduty.schedule.entry-timeframe=   获取排班条目的PagerDuty时间范围（time.Duration）（默认：72h）[$PAGERDUTY_SCHEDULE_ENTRY_TIMEFRAME]
      --pagerduty.schedule.entry-timeformat=  排班条目时间格式（标签）（默认：Mon, 02 Jan 15:04 MST）[$PAGERDUTY_SCHEDULE_ENTRY_TIMEFORMAT]
      --pagerduty.incident.timeformat=        事件时间格式（标签）（默认：Mon, 02 Jan 15:04 MST）[$PAGERDUTY_INCIDENT_TIMEFORMAT]
      --pagerduty.disable-teams               设置为true以禁用检查PagerDuty团队（适用于不包含团队功能的计划）[$PAGERDUTY_DISABLE_TEAMS]
      --pagerduty.team-filter=                在适用时将团队ID作为列表选项传递 [$PAGERDUTY_TEAM_FILTER]
      --pagerduty.max-connections=            到PagerDuty API的最大TCP连接数（并发）（默认：4）[$PAGERDUTY_MAX_CONNECTIONS]
      --bind=                                 服务器地址（默认：:8080）[$SERVER_BIND]
      --scrape.time=                          抓取时间（time.duration）（默认：5m）[$SCRAPE_TIME]
      --scrape.time.live=                     事件和值班的抓取时间（time.duration）（默认：1m）[$SCRAPE_TIME_LIVE]

帮助选项:
  -h, --help                                  显示此帮助信息

--pagerduty.authtoken= 是必填选项。请参考文档了解如何生成令牌。

安装和运行Exporter

Go

可通过以下命令获取exporter：

go get github.com/webdevops/pagerduty-exporter

之后，您可以按照配置部分所述运行exporter。

容器

可通过 docker pull webdevops/pagerduty-exporter 获取容器化版本。或者您也可以本地构建镜像：

git clone ***:webdevops/pagerduty-exporter.git && cd pagerduty-exporter
docker build -t webdevops/pagerduty-exporter:latest .

现在，您可以通过以下命令在本地容器中运行exporter：

docker run --rm -ti -p 8080:8080 webdevops/pagerduty-exporter:latest --pagerduty.authtoken=你的生成令牌

这将在本地运行容器，将容器的8080端口映射到本地8080端口，使您可以在 127.0.0.1:8080/metrics 抓取exporter。

指标

Prometheus查询

当前值班人员

pagerduty_schedule_oncall{scheduleID="$SCHEDULEID",type="startTime"}
* on (userID) group_left(userName) (pagerduty_user_info)

下一班次

bottomk(1,
  min by (userName, time) (
    pagerduty_schedule_final_entry{scheduleID="$SCHEDULEID",type="startTime"}
    * on (userID) group_left(userName) (pagerduty_user_info) 
  ) - time() > 0
)