radiantone/fid-exporter

fid-exporter

镜像概述和主要用途

fid-exporter是一个用于FID的Prometheus指标导出器，主要用途是收集FID（Federated Identity Director）相关指标，并将这些指标提供给Prometheus监控系统，以便进行指标存储、分析和告警。该导出器支持两种工作模式：拉取模式（PULL MODE）和推送模式（PUSH MODE），可根据监控需求灵活配置。

核心功能和特性

• 支持Prometheus拉取模式，允许Prometheus主动从导出器获取FID指标
• 支持推送模式，可定期将指标推送到Prometheus Pushgateway
• 通过环境变量灵活配置LDAP连接信息、推送参数等
• 提供多种部署方式，包括本地运行、Docker容器、docker-compose和Kubernetes

环境变量

构建Docker镜像

以下命令中的<TAG_NAME>必须与您要推送镜像的位置名称相同

bash
docker build . --tag <TAG_NAME>

示例

bash
docker build . --tag <TAG_NAME>

推送构建的镜像到仓库

bash
docker push <TAG_NAME>

示例

bash
docker push <TAG_NAME>

本地运行导出器

克隆项目并确保您的机器上已安装golang

bash
# 运行./run_dev.sh需要以下环境变量
export LDAP_URI="ldap://localhost:2389"
export BIND_DN="cn=Directory Manager"
export BIND_PASSWORD="secret1234"
./run_dev.sh

使用Docker运行导出器

拉取模式（PULL MODE）

bash
docker run -e LDAP_URI="ldap://HOSTNAME:2389" -e BIND_DN="cn=Directory Manager" -e BIND_PASSWORD="PASSWORD" -p 9095:9095 --name fid-exporter radiantone/fid-exporter

推送模式（PUSH MODE）

bash
docker run --rm -e PUSH_MODE=true -e PUSHGATEWAY_URI="http://pushgateway:9091" -e LDAP_URI="ldap://fid-0:2389" -e BIND_DN="cn=Directory Manager" -e BIND_PASSWORD="secret1234" -e INSTANCE_NAME="fid-0" -e JOB_NAME="fid-targets" -e PUSH_METRICS_CRON="*/10 * * * *" -p 9095:9095 --name fid-exporter radiantone/fid-exporter

使用docker-compose运行导出器

拉取模式（PULL MODE）

yaml
...
  fid-exporter:
    image: radiantone/fid-exporter
    environment: 
      - LDAP_URI=ldap://fid-0:2389
      - BIND_DN=cn=Directory Manager
      - BIND_PASSWORD=secret1234
    ports:
      - "9095:9095"
    depends_on:
      fid-0:
        condition: service_healthy
    networks:
      fid-net:
        aliases:
          - fid-exporter
...

推送模式（PUSH MODE）

yaml
...
  fid-exporter:
    image: radiantone/fid-exporter
    environment: 
      - PUSH_MODE=true
      - PUSHGATEWAY_URI=http://pushgateway:9091
      - INSTANCE_NAME=fid-0
      - LDAP_URI=ldap://fid-0:2389
      - BIND_DN=cn=Directory Manager
      - BIND_PASSWORD=secret1234
    ports:
      - "9095:9095"
    depends_on:
      fid-0:
        condition: service_healthy
    networks:
      fid-net:
        aliases:
          - fid-exporter
...

使用Kubernetes运行导出器

拉取模式（PULL MODE）

yaml
apiVersion: apps/v1 
kind: Deployment
metadata:
  name: fid-exporter
spec:
  strategy:
    type: Recreate
  selector:
    matchLabels:
      app: fid-exporter
  replicas: 1
  template: 
    metadata:
      labels:
        app: fid-exporter
    spec:
      containers:
      - name: fid-exporter
        image: radiantone/fid-exporter
        env:
          - name: LDAP_URI
            value: "ldap://HOSTNAME:2389"
          - name: BIND_DN
            value: "cn=Directory Manager"
          - name: BIND_PASSWORD
            value: "PASSWORD"
        ports:
        - containerPort: 9095

推送模式（PUSH MODE）

yaml
apiVersion: apps/v1 
kind: Deployment
metadata:
  name: fid-exporter
spec:
  strategy:
    type: Recreate
  selector:
    matchLabels:
      app: fid-exporter
  replicas: 1
  template: 
    metadata:
      labels:
        app: fid-exporter
    spec:
      containers:
      - name: fid-exporter
        image: radiantone/fid-exporter
        env:
          - name: PUSH_MODE
            value: "true"
          - name: PUSHGATEWAY_URI
            value: "[***]"
          - name: INSTANCE_NAME
            value: "fid-0"
          - name: LDAP_URI
            value: "ldap://HOSTNAME:2389"
          - name: BIND_DN
            value: "cn=Directory Manager"
          - name: BIND_PASSWORD
            value: "PASSWORD"
        ports:
        - containerPort: 9095