billykwooten/openweather-exporter Docker Image Overview

billykwooten/openweather-exporter

billykwooten

用于通过OpenWeather API收集天气指标的Prometheus导出器，支持温度、湿度、空气质量等数据，并可集成到Prometheus和Grafana进行监控。

1 收藏0 次下载

💣 CI/CD 卡在拉镜像？问题不在代码，在镜像源

中文简介版本下载

💣 CI/CD 卡在拉镜像？问题不在代码，在镜像源

OpenWeather 导出器

!Docker Pulls !Docker Automated ![report]([] ![license]([] ![release]([***] !Go Version

用于OpenWeather API的Prometheus导出器。

注意：从本导出器的0.0.12版本开始，您需要注册API 3.0免费或付费订阅，您的API密钥才能生效。

要求

Linux / MacOSX，Windows需使用git bash
docker
OpenWeather API 3.0订阅（免费或付费）

开发环境

go
openweathermap库

配置

OpenWeather导出器可通过环境变量（ENV）或命令行标志（CLI flags）进行控制，如下所述。

启用OW_ENABLE_POL将增加API调用次数以拉取污染/空气质量数据，请注意您的API调用量，以免产生费用。详见OpenWeather定价此处。

环境变量	CLI标志（`--flag`）	默认值	描述
`OW_LISTEN_ADDRESS`	`listen-address`	`:9091`	`/metrics`端点监听的端口
`OW_APIKEY`	`apikey`	`<必填>`	您的OpenWeather API密钥
`OW_CITY`	`city`	`New York, NY`	收集天气指标的城市/位置。多个位置用`\|`分隔，例如"New York, NY\|Seattle, WA"
`OW_DEGREES_UNIT`	`degrees-unit`	`F`	温度单位（开尔文、华氏度或摄氏度）
`OW_LANGUAGE`	`language`	`EN`	指标显示的语言
`OW_CACHE_TTL`	`cache-ttl`	`300`	缓存生存时间（秒）
`OW_ENABLE_POL`	`enable-pol`	`false`（布尔值）	启用污染指标

使用方法

二进制使用

bash
# 使用二进制从西雅图收集天气指标，并启用污染/紫外线指标
./openweather-exporter --city "Seattle, WA" --apikey mi4o2n54i0510n4510 --enable-pol

Docker使用

bash
# 使用Docker从西雅图收集天气指标
docker run -d --restart on-failure --name=openweather-exporter -p 9091:9091 billykwooten/openweather-exporter --city "Seattle, WA" --apikey mi4o2n54i0510n4510

Docker Compose使用

yaml
  openweather-exporter:
    image: billykwooten/openweather-exporter
    container_name: openweather-exporter
    restart: always
    ports:
      - "9091:9091"
    environment:
      - OW_CITY=New York, NY
      - OW_APIKEY=mi4o2n54i0510n4510
      - OW_ENABLE_POL=true

Prometheus抓取配置

yaml
scrape_configs:
  - job_name: 'openweather-exporter'
    scrape_interval: 60s
    static_configs:
      - targets: ['openweather-exporter:9091']

收集的指标

以下是导出器默认收集的OpenWeather指标。

默认指标

指标名称	描述
`openweather_temperature`	当前温度（度）
`openweather_humidity`	当前相对湿度
`openweather_feelslike`	当前体感温度（度， heat index）
`openweather_pressure`	当前大气压力（百帕）
`openweather_windspeed`	当前风速（英里/小时，若为英制则为米/秒）
`openweather_rain1h`	过去1小时降雨量（毫米）
`openweather_snow1h`	过去1小时降雪量（毫米）
`openweather_winddegree`	风向（度，气象学角度）
`openweather_cloudiness`	云量（百分比）
`openweather_sunrise`	日出时间（Unix时间戳，UTC）
`openweather_sunset`	日落时间（Unix时间戳，UTC）
`openweather_currentconditions`	当前天气状况（晴天、多云、雨天等）
`openweather_ultraviolet_index`	紫外线指数

启用污染指标后额外指标

若启用污染指标，将增加以下指标：

指标名称	描述
`openweather_pollution_airqualityindex`	空气质量指数。1=优，2=良，3=轻度污染，4=中度污染，5=重度污染。
`openweather_pollution_carbonmonoxide`	一氧化碳（CO）浓度（μg/m³）
`openweather_pollution_nitrogenmonoxide`	一氧化氮（NO）浓度（μg/m³）
`openweather_pollution_nitrogendioxide`	二氧化氮（NO₂）浓度（μg/m³）
`openweather_pollution_ozone`	臭氧（O₃）浓度（μg/m³）
`openweather_pollution_sulphurdioxide`	二氧化硫（SO₂）浓度（μg/m³）
`openweather_pollution_pm25`	PM2.5（细颗粒物）浓度（μg/m³）
`openweather_pollution_pm10`	PM10（粗颗粒物）浓度（μg/m³）
`openweather_pollution_nh3`	氨（NH₃）浓度（μg/m³）