Skip to content

MonitoringPlugin fi FI

ArchiBot edited this page Aug 8, 2026 · 8 revisions

Seuranta Liitännäinen

MonitoringPlugin on virallinen ASF plugin, jonka avulla voit seurata ASF-prosessia Prometheus aikasarjatietokannan kautta.


Kuvakaappaukset

Näytä

screenshot


Vaatimukset

Koska teknisiä rajoitteita, tämä liitännäinen vaatii ASF generic-variantin.


Liitännäisen käyttöönotto

ASF ei ei mukana MonitoringPlugin-nipussa oletuksena, mutta se sisältyy valinnaisena lisänä jokaisessa ASF-julkaisussa. Lataa lisäosa viralliselta release joka vastaa ASF-versiota, ja luo sitten oma plugins/ArchiSteamFarm. fficialPlugins.Monitoring hakemisto plugin, ja lopuksi pura arkisto siellä.

Seuraavan käynnistyksen ASF lokit osoittavat, että plugin on onnistuneesti ladattu standardin ASF kirjausmekanismi. Voit myös tarkistaa tämän navigoimalla osoitteeseen /Api/metrics URL-osoitteeseen IPC-käyttöliittymässäsi. Jos käytät IPC-salasanaa, tarvitset oikean valtuutuksen, esim. lisäämällä ?password=<YourIPCPassword> /Api/metrics URL. Näyttämäsi sisältö pitäisi näyttää samalta kuin alla:

# TYPE asf_build_info gauge
# HELP asf_build_info Rakenna tietoa ASF:sta tarran arvojen muodossa
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 label values
asf_runtime_info{framework=". ET 8.0.4",operating_system="Debian GNU/Linux trixie/sid",runtime="linux-x64"} 1 1713715703686
(...)

ASF:ää ja bootteja koskevat mittarit ovat omistaneet nimessään asf_-etuliitteen. Muut mittarit, esim. .NET runtime tai ASF HttpClient, generoidaan automaattisesti universaalin .NET prosessin sääntöjen perusteella eivätkä ne kanna tällaista etuliitettä.


Prometheus config

Kun olet varmistanut, että liitännäinen toimii oikein, voit lisätä raaputusmäärityksen Prometheus esimerkiksi näin:

scrape_configs:
  - job_name: ArchiSteamFarm
    metric_name_escaping_scheme: alaviivoja # Poista käyttämällä Prometheus V2:ta. - lue lisää
    metrics_path: /Api/metrics
    params:
      salasana:
        - YourIPCPassword
    static_configs:
      - kohteet:
          - 127. .0.1:1242

Luonnollisesti sinun täytyy varmistaa, että isännöi Prometheus instanssi pystyy saavuttamaan ASF:n IPC-käyttöliittymän, sovittaa password ja targets sen mukaisesti käyttöösi. Jos sinulla ei ole IPC-salasanaa (jota ei suositella), voit ohittaa params-osion lisäämisen. Jos käytät useita ASF instansseja eri IPC salasanoja, voit lisätä ylimääräisiä kaakaoasetuksia, yksi kutakin esimerkkiä kohden, koska kyselyn parametreja ei voida määrittää tavoitekohtaisesti. Muussa tapauksessa voit ilmoittaa useita kohteita, jos niillä on sama salasana.


Grafana kojelauta

Kun mittauksesi on koottu Prometheuksen toimesta, on mahdollista käyttää Grafana visualisointiin. Liitännäisessä on /grafana-kojelauta. son tiedosto palvelee standardin IPC mekanismit, joten olettaen, että käytät ASF instanssia oletusasetukset, voit ladata sen here. Vaihtoehtoisesti voit myös napata JSON tiedoston meidän repository myös.


Prometheus, Grafana kojelauta ja mittareita pakenemisen järjestelmä

ASF tukee useita mittareita pakenevia järjestelmiä, koska V6.3.8.4, yhtenäinen, täydellinen ratkaisu alkaa V6.3.9.4 (osana #3607).

Tämä aiheuttaa valitettavasti hieman kysymyksen Grafana kojelautaan, koska että työtä varten tarvitset tarkkoja metrisiä nimiä kuin jäsennelty Prometheus, ja että ohjelmisto toimii oletusarvoisesti kahdella eri tavalla riippuen siitä, käytätkö V2:ta. tai V3.x versio siitä. Katso lisätietoja UTF-8 Prometheus docs

Kun odotamme Prometheus V3.x:n omaksumista laajasti (nykyisinä ohjeina debianitasoineen), suosittelemme perinnöllistä lähestymistapaa, joka on:

  • Grafana-kojelaudalla on oletusarvoisesti alleviivatut nimet, jotka Prometheus V2.x tunnistaa
  • Käytä metric_name_escaping_scheme: underscores osana ASF-kaavan määrittelyä (kuten edellä), jos käytät Prometheus V3.x-tiedostoa

Tämä johtuu siitä, että vaikka Prometheus V3.x voidaan helposti konfiguroida käyttämään perinnöllistä lähestymistapaa, Prometheus V2. ei ole sellaista työpaikkakohtaista vaihtoehtoa pakottaa käytettävää uutta vaihtoehtoa.

Tulevaisuudessa me todennäköisesti refactor meidän Grafana kojelauta käyttää uusia suositeltuja oletuksia, ja asetusta ei enää tarvita. Tällä hetkellä se aiheuttaisi ongelmia vanhemmille Prometheuksen käyttäjille, mikä ei ole perusteltua.

Tietenkin plugin ASF itsessään tukee kaikkia eri muotoiluvaihtoehtoja, joten voit aina valita yhden haluamasi ja mukauttaa Grafana kojelauta itse - olemme vain tehdä siitä helpompaa sinulle yksinkertaisella yhden rivin config muutos suositus.

Clone this wiki locally