MonitoringPlugin no NO

OvervåkingPlugin

MonitoringPlugin er en offisiell ASF plugin, slik at du kan overvåke ASF-prosess via Prometheus tidsseriedatabase.

---

Skjermbilder

Vis

---

Krav

På grunn av tekniske begrensninger, krever denne utvidelsen generic variant av ASF.

---

Aktiverer utvidelsen

ASF kommer ikke med MonitoringPlugin som standard, men den er inkludert som valgfritt tillegg i hver ASF-utgivelse. Last ned utvidelsen fra de offisielle release som samsvarer med din ASF-versjon, og lag deretter en dedikert plugins/ArchiSteamFarm. fficialPlugins.Monitoring mappen for utvidelsen og kan endelig pakke ut arkivet der.

Ved neste lansering av ASA vil loggene indikere at utvidelsen har blitt vellykket lastet gjennom standard ASF loggemekanisme. Du kan også bekrefte dette ved å navigere til /Api/metrics-adressen i IPC-grensesnittet. Hvis du bruker IPC passord, trenger du riktig godkjenning, f.eks å legge til ?password=<YourIPCPassword> til /Api/metrics URL. Innholdet du ser skal se likt ut:

# TYPE asf_build_info gauge
# HELP asf_build_info Bygge informasjon om ASF i form av etikettverdier
asf_build_info{variant="source",version="6.0.2. "} 1 1713715703686

TYPE asf_runtime_info gauge
# HELP asf_runtime_info Runtime information about ASF in form of label values
asf_runtime_info{framework=". ET 8.0.4",operating_system="Debian GNU/Linux trixie/sid",runtime="linux-x64"} 1 1713715703686
(...)

Måltall om ASF og botene har dedikert prefiks asf_ i navnet. Andre måltall, for eksempel om driftstid eller ASFs HttpClient genereres automatisk basert på universelle .NET-prosessregler og er ikke utstyrt med slik prefiks.

---

Prometheus konfigurasjon

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
    metric_name_escaping_scheme: understreker # Remove om du bruker Prometheus V2. - les mer under
    metrics_path: /Api/metrics
    params:
      password:
        - YourIPCPassword
    static_configs:
      - mål:
          - 127. .0.1:1242

Du må selvsagt forsikre deg om at vertene dine Prometheus forekomsten er i stand til å nå ASFs IPC-grensesnitt. tilpasser derfor "passord" og "mål" til bruken din. Hvis du ikke har angitt IPC-passord (som ikke er anbefalt), kan du hoppe over adgangen i params-avsnittet. Dersom du kjører flere ASF-forekomster med forskjellige IPC-passord, kan du legge til flere scrape-konfigurasjoner, én for eksempel, siden parameteren for spørring ikke kan settes for hvert mål. Ellers kan du erklære flere mål hvis de deler det samme passordet.

---

Grafana dashboard

Når måltallene er samlet inn av Prometheus, er det mulig å bruke Grafana for visualisering. Plugin kommer med /grafana-dashboard. son-filen er servert av standard IPC-mekanismer, så forutsatt at du kjører ASF-forekomsten din med standardinnstillinger, du kan laste den ned here. Alternativt kan du også velge JSON-filen fra vår repository også.

---

Prometeus, Grafana dashbord og rømming av måltall

ASF støtter ulike måltall som slipper ut etter V6.3.8.4, med enhetlig, komplett løsning som starter V6.3.9.4 (som en del av #3607).

Det har dessverre vært en svak problemstilling når det gjelder vårt Grafana-dashbord. siden du trenger presise måltallsnavn som analysert av Prometeus, og at programvare fungerer på to forskjellige måter som standard, avhengig av om du bruker V2. eller V3.x versjon av det. Se UTF-8 Prometheus docs for mer info.

Mens du venter på Prometeus V3.x for å bli bredt brukt (med debian stable som gjeldende retningslinjer), anbefaler vi her en eldre tilnærming som er:

• Vår Grafana dashbord kommer med understrekingsnavn som standard, som er gjenkjent av Prometheus V2.x
• Bruk metric_name_escaping_scheme: underscores som en del av ASF-scrape config (som i eksempelet ovenfor), hvis du bruker Prometheus V3.x

Dette er fordi, mens Prometheus V3.x kan konfigureres enkelt til å bruke arven tilnærming, Prometheus V2. har ingen slik jobb-spesifikk opsjon for å tvinge den nye til å brukes.

I fremtiden vil vi sannsynligvis refaktorere vår Grafana dashbord til å bruke de nye anbefalte standardene, og innstillingen vil ikke være nødvendig lenger. Det er i dag grunn grunn til å gjøre noe for eldre brukere av Prometheus som ikke er berettiget.

Pluginen i ASF støtter selvfølgelig alle forskjellige formateringsalternativer, Derfor kan du alltid velge det du liker og tilpasse Grafana dashbordet selv - vi gjør det enklere for deg med en enkel endosebeholder konfigurasjon.