dachack/airthings-exporter

Airthings Exporter

Airthings设备的Prometheus导出器Docker镜像，用于将Airthings设备数据导出至Prometheus监控系统。Docker Hub链接：https://hub.docker.com/r/dachack/airthings-exporter

镜像概述

本镜像提供Airthings设备与Prometheus的集成能力，通过Airthings API获取设备数据并转换为Prometheus可抓取的指标格式，实现Airthings设备监控数据的集中化收集与分析。

核心功能与特性

• 支持Airthings设备数据导出至Prometheus
• 通过环境变量配置认证信息（client_id、client_secret、device_id）
• 与Prometheus无缝集成，提供标准HTTP指标接口
• 支持容器自动重启策略配置

使用场景

适用于需要将Airthings设备（如室内空气质量监测设备）数据集成到Prometheus监控体系的场景，适用于拥有Airthings View Plus、Wave Mini等设备的个人或企业用户。

使用方法

前置配置

1. 按设备手册注册Airthings设备并同步至云端
2. 通过Airthings应用或网页控制台获取设备序列号（作为client_id）
3. 访问Airthings集成页面申请API客户端，获取client_secret
4. 确保容器与Prometheus服务器处于同一虚拟网络

Docker Compose配置示例

yaml
airthings-exporter:
  container_name: airthings-exporter
  image: dachack/airthings-exporter
  networks:
    - prometheus
  environment:
    client_id: YOUR_CLIENT_ID  # 替换为设备序列号
    client_secret: YOUR_SECRET  # 替换为API客户端密钥
    device_id: YOUR_DEVICE_ID  # 替换为设备ID
  restart: unless-stopped

测试设备

• Airthings View Plus
• Airthings Wave Mini

Prometheus配置示例

在Prometheus配置文件（prometheus.yml）中添加以下抓取配置：

yaml
scrape_configs:
  - job_name: 'airthings'
    scrape_interval: 5m  # 抓取间隔，需符合API限制
    scrape_timeout: 10s
    static_configs:
      - targets: ['localhost:8000']  # 替换为airthings-exporter容器地址:端口

API限制说明

Airthings消费者API限制每小时最多120次请求。Prometheus每次抓取会对每个设备发起一次API请求，需确保配置的scrape_interval不导致请求频率超出限制。