MonitoringPlugin ru RU

Плагин мониторинга

MonitoringPlugin is an official ASF plugin, which allows you to monitor ASF process via Prometheus time-series database.

---

Скриншоты

Раскрыть

---

Требования

Из-за технических ограничений для этого плагина требуется generic вариант ASF.

---

Активация плагина

ASF не поставляется в комплекте MonitoringPlugin по умолчанию, однако он включен в качестве дополнения в каждом релизе ASF. Загрузите плагин с официального релиза, который соответствует вашей версии ASF, а затем создайте выделеннyю папкуplugins/ArchiSteamFarm.OfficialPlugins.Monitoring для плагина, и, наконец, распакуйте архив там.

On the next launch of ASF, the logs will indicate that the plugin has been successfully loaded through standard ASF logging mechanism. You can also verify this by navigating to /Api/metrics URL in your IPC interface. Если вы используете пароль IPC, вам понадобится соответствующая авторизация, например добавить ?password=<YourIPCPassword> к адресу/Api/metrics. Контент, который вы видите должен выглядеть примерно так:

# TYPE asf_build_info gauge
# HELP asf_build_info Информация о сборке ASF в виде значений меток
asf_build_info{variant="source",version="6.0.2. "} 1 1713715703686

# TYPE asf_runtime_info gauge
# HELP asf_runtime_info Информация о работе ASF в виде значений меток
asf_runtime_info{фреймворк=". ET 8.0.4",operating_system="Debian GNU/Linux trixie/sid",runtime="linux-x64"} 1 1713715703686
(...)

Metrics regarding ASF and the bots have dedicated prefix asf_ in their name. Other metrics e.g. regarding the .NET runtime or ASF's HttpClient are automatically generated based on universal .NET process rules and do not carry such prefix.

---

Prometheus config

Once you verified the plugin is working correctly, you can add a scrape configuration to your Prometheus instance as such:

scrape_configs:
  - job_name: ArchiSteamFarm
    metrics_path: /Api/metrics
    params:
      password:
        - YourIPCPassword
    static_configs:
      - targets:
          - 127.0.0.1:1242

Naturally, you need to ensure that your hosted Prometheus instance is able to reach ASF's IPC interface, adapt password and targets accordingly to your usage. If you do not have IPC password set (which is not recommended), you can skip the addition of the params section. In case you're running multiple ASF instances with different IPC passwords, you can add additional scrape configurations, one per instance, as the query parameters can not be set on a per-target basis. Otherwise, you can declare several targets if they share the same password.

---

Grafana dashboard

Once your metrics are gathered by Prometheus, it's possible to use Grafana for visualization. The plugin comes with /grafana-dashboard.json file served by standard IPC mechanisms, so assuming you're running your ASF instance with default settings, you can download it here. Alternatively, you can also grab the JSON file from our repository as well.