Jenkins

·

Jenkins 采集器是通过插件 Metrics 采集数据监控 Jenkins，包括但不限于任务数、系统 CPU 使用、JVM CPU 使用等。

配置¶

前置条件¶

• JenKins 版本 >= 2.332.1; 已测试的版本：

  • 2.332.1

• 下载 Metric 插件，管理插件页面,Metric 插件页面

• 在 JenKins 管理页面 your_manage_host/configure 生成 Metric Access keys

[[inputs.jenkins]]
  ## Set true if you want to collect metric from url below.
  enable_collect = true

  ## The Jenkins URL in the format "schema://host:port",required
  url = "http://my-jenkins-instance:8080"

  ## Metric Access Key ,generate in your-jenkins-host:/configure,required
  key = ""

  # ##(optional) collection interval, default is 30s
  # interval = "30s"

  ## Set response_timeout
  # response_timeout = "5s"

  ## Set true to enable election
  # election = true

  ## Optional TLS Config
  # tls_ca = "/xx/ca.pem"
  # tls_cert = "/xx/cert.pem"
  # tls_key = "/xx/key.pem"
  ## Use SSL but skip chain & host verification
  # insecure_skip_verify = false

  ## set true to receive jenkins CI event
  enable_ci_visibility = true

  ## which port to listen to jenkins CI event
  ci_event_port = ":9539"

  # [inputs.jenkins.log]
  # files = []
  # #grok pipeline script path
  # pipeline = "jenkins.p"

  [inputs.jenkins.tags]
  # some_tag = "some_value"
  # more_tag = "some_other_value"
  # ...

  [inputs.jenkins.ci_extra_tags]
  # some_tag = "some_value"
  # more_tag = "some_other_value"

Jenkins CI Visibility¶

Jenkins 采集器可以通过接收 Jenkins DataDog plugin 发出的 CI Event 实现 CI 可视化。

Jenkins CI Visibility 开启方法：

• 确保在配置文件中开启了 Jenkins CI Visibility 功能，且配置了监听端口号（如 :9539），重启 Datakit；
• 在 Jenkins 中安装 Jenkins Datadog plugin ；
• 在 Manage Jenkins > Configure System > Datadog Plugin 中选择 Use the Datadog Agent to report to Datadog (recommended)，配置 Agent Host 为 Datakit IP 地址。DogStatsD Port 及 Traces Collection Port 两项均配置为上述 Jenkins 采集器配置文件中配置的端口号，如 9539（此处不加 :）；
• 勾选 Enable CI Visibility；
• 点击 Save 保存设置。

配置完成后 Jenkins 能够通过 Datadog Plugin 将 CI 事件发送到 Datakit。

指标¶

以下所有数据采集，默认会追加全局选举 tag，也可以在配置中通过 [inputs.jenkins.tags] 指定其它标签：

 [inputs.jenkins.tags]
  # some_tag = "some_value"
  # more_tag = "some_other_value"
  # ...

可以在配置中通过 [inputs.jenkins.ci_extra_tags] 为 Jenkins CI Event 指定其它标签：

 [inputs.jenkins.ci_extra_tags]
  # some_tag = "some_value"
  # more_tag = "some_other_value"

jenkins¶

• 标签

• 指标列表

jenkins_pipeline¶

• 标签

• 指标列表

jenkins_job¶

• 标签

• 指标列表

日志¶

如需采集 JenKins 的日志，可在 jenkins.conf 中 将 files 打开，并写入 JenKins 日志文件的绝对路径。比如：

[[inputs.JenKins]]
  ...
  [inputs.JenKins.log]
    files = ["/var/log/jenkins/jenkins.log"]

开启日志采集以后，默认会产生日志来源（source）为 jenkins 的日志。

注意：必须将 DataKit 安装在 JenKins 所在主机才能采集 JenKins 日志

日志 Pipeline 功能切割字段说明¶

• JenKins 通用日志切割

通用日志文本示例：

2021-05-18 03:08:58.053+0000 [id=32] INFO jenkins.InitReactorRunner$1#onAttained: Started all plugins

切割后的字段列表如下：