MonitoringPlugin ro RO

MonitorizPlugin

MonitoringPlugin este un ASF oficial plugin, care vă permite să monitorizați procesul ASF prin Prometheus baza de date cu serii orare.

---

Capturi ecran

Arata

---

Cerințe

Din cauza constrângerilor tehnice, acest plugin necesită varianta generic a ASF.

---

Activarea plugin-ului

ASF nu vine cu MonitoringPlugin pachetat în mod implicit, totuși, este inclus ca adaos opțional în fiecare lansare ASF. Descarcă plugin-ul din release care corespunde versiunii tale ASF, apoi creează un "plugins/ArchiSteamFarm" dedicat. folderul fficialPlugins.Monitoring' pentru plugin și în cele din urmă extrageți arhiva acolo.

La următoarea lansare a ASF, jurnalele vor indica faptul că plugin-ul a fost încărcat cu succes prin mecanismul standard de logare ASF. De asemenea, puteţi verifica acest lucru navigând la URL-ul /Api/metrics din interfaţa IPC. Dacă folosiți parola IPC, veți avea nevoie de o autorizație corectă, de ex. adăugare ?password=<YourIPCPassword> la URL-ul /Api/metrics. Conţinutul pe care îl vedeţi trebuie să fie similar cu cel de mai jos:

# TYPE asf_build_info gauge
# HELP asf_build_info Build informații despre ASF sub forma valorilor etichetei
asf_build_info{variant="source",version="6.0.2. "} 1 1713715703686

# TYPE asf_runtime_info gauge
# HELP asf_runtime_info Runtime informații despre ASF sub forma valorilor etichetei
asf_runtime_info{framework=". ET 8.0.4",operating_system="Debian GNU/Linux trixie/sid",runtime="linux-x64"} 1 1713715703686
(...)

Metrici cu privire la ASF și boți au dedicat prefixul asf_ în numele lor. Alți indicatori referitori la .NET runtime sau la HttpClient de la ASF sunt generați automat pe baza regulilor universale de proces NET și nu poartă astfel de prefix.

---

Configurare Prometheus

Odată ce ați verificat plugin-ul funcționează corect, puteți adăuga o configurație de răzuire la instanța Prometheus ca atare:

scrape_configs:
  - job_name: ArchiSteamFarm
    metric_name_escaping_scheme: underscore # Remove if using Prometheus V2. - citește mai mult sub
    metrics_path: /Api/metrics
    params:
      parola:
        - YourIPCPassword
    static_configs:
      - ținte:
          - 127. .0.1:1242

Bineînțeles, trebuie să te asiguri că instanța ta găzduită Prometheus poate ajunge la interfața IPC a ASF. adaptați password și targets corespunzător la utilizarea dumneavoastră. Dacă nu aveţi o parolă IPC setată (care nu este recomandată), puteţi sări peste adăugarea secţiunii params. În cazul în care rulați mai multe instanțe ASF cu parole IPC diferite, puteți adăuga configurații suplimentare pentru resturi, 1 per exemplu, deoarece parametrii interogării nu pot fi setați pentru fiecare țintă. În caz contrar, puteți declara mai multe ținte dacă acestea au aceeași parolă.

---

Panou de control

Odată ce măsurătorile sunt colectate de Prometheus, este posibil să utilizaţi Grafana pentru vizualizare. Plugin-ul vine cu /grafana-dashboard. fișierul son servit de mecanismele standard IPC, deci presupunând că rulați instanța ASF cu setările implicite, îl puteţi descărca here. Alternativ, poți deasemenea să iei fișierul JSON din repository de asemenea.

---

Prometheus, tabloul de bord al Grafana și schema de evacuare a măsurătorilor

ASF suportă diferite scheme de scăpare de la V6.3.8.4, cu soluţie unificată, completă începând de la V6.3.9.4 (ca parte din #3607).

Din păcate, acest lucru cauzează o mică problemă în ceea ce privește tabloul nostru de bord Grafana, de vreme ce pentru ca aceasta să funcţioneze aveţi nevoie de denumiri metrice precise, aşa cum sunt tratate de Prometheus, şi acest software se comportă în două moduri diferite, în funcţie de utilizarea lui V2. or V3.x version of it. Vezi UTF-8 documente Prometheus pentru mai multe informații.

În timp ce aşteptăm ca Prometheus V3.x să fie adoptat pe scară largă (cu debian stabil ca orientare curentă), recomandăm abordarea moştenirii, şi anume:

• Panoul nostru de control Grafana vine cu numele de jos în mod implicit, care sunt recunoscute de Prometheus V2.x
• Folosiți metric_name_escaping_scheme: underscores ca parte a configurării scrap-ului ASF (ca în exemplul de mai sus), dacă folosiți Prometheus V3.x

Asta pentru că, în timp ce Prometheus V3.x poate fi configurat cu uşurinţă să folosească abordarea veche, Prometheus `V2. „nu dispune de o astfel de opțiune specifică locului de muncă pentru a forța utilizarea noii opțiuni.

În viitor, vom relua probabil tabloul nostru de bord Grafana pentru a utiliza noile valori implicite recomandate, iar setarea nu va mai fi necesară. În prezent, acest lucru ar crea probleme pentru utilizatorii mai în vârstă de Prometheus, ceea ce nu este garantat.

Bineînțeles, plugin-ul în ASF însuși suportă toate opțiunile de formatare, astfel încât să îl poți alege întotdeauna pe cel care îți place și să îl adaptezi singur la panoul de control Grafana - noi îți facilităm doar cu o simplă recomandare de schimbare a configurațiilor cu o singură linie.