MonitoringPlugin el GR

Πρόσθετο Παρακολούθησης

Το MonitoringPlugin είναι μια επίσημη ASF plugin, η οποία σας επιτρέπει να παρακολουθείτε τη διαδικασία ASF μέσω Prometheus της βάσης δεδομένων χρονοσειρών.

---

Στιγμιότυπα οθόνης

Show

---

Απαιτήσεις

Λόγω του τεχνικών περιορισμών, αυτό το πρόσθετο απαιτεί την "γενική" παραλλαγή του ASF.

---

Ενεργοποίηση της πρόσθετης λειτουργίας

Το ASF δεν έρχεται με το MonitoringPlugin ομαδοποιημένο από προεπιλογή, ωστόσο, περιλαμβάνεται ως προαιρετική προσθήκη σε κάθε έκδοση ASF. Κατεβάστε το πρόσθετο από το επίσημο release που ταιριάζει με την έκδοση ASF και στη συνέχεια δημιουργήστε ένα ειδικό plugins/ArchiSteamFarm. fficialPlugins.Monitoring directory για το plugin, και τελικά εξαγάγετε την αρχειοθήκη εκεί.

Στην επόμενη εκκίνηση του ASF, τα αρχεία καταγραφής θα υποδηλώνουν ότι το plugin έχει φορτωθεί με επιτυχία μέσω του τυπικού μηχανισμού καταγραφής ASF. Μπορείτε επίσης να το επιβεβαιώσετε αυτό μεταβαίνοντας στο URL /Api/metrics στη διεπαφή IPC. Αν χρησιμοποιείτε κωδικό πρόσβασης IPC, θα χρειαστείτε κατάλληλη εξουσιοδότηση, π.χ. προσάρτηση ?password=<YourIPCPassword> στο URL /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{framework=". ET 8. 0. 4",operating_system="Debian GNU/ Linux trixie/sid",runtime="linux- x64"} 1 1713715703686
(...)

Οι μετρήσεις σχετικά με το ASF και τα bots έχουν αφιερώσει το πρόθεμα asf_ στο όνομά τους. Άλλες μετρήσεις, π.χ. σχετικά με το χρόνο εκτέλεσης .NET ή το HttpClient του ASF δημιουργούνται αυτόματα με βάση καθολικούς κανόνες .NET διεργασιών και δεν φέρουν τέτοιο πρόθεμα.

---

Prometheus config

Μόλις επαληθεύσετε ότι το πρόσθετο λειτουργεί σωστά, μπορείτε να προσθέσετε μια παραμετροποίηση απόξεσης στην παρουσία Prometheus ως έχει:

scrape_configs:
  - job_name: ArchiSteamFarm
    metric_name_escaping_scheme: κάτω παύλες # Αφαιρέστε αν χρησιμοποιείτε το Prometheus V2. - Διαβάστε περισσότερα παρακάτω
    metrics_path: /Api/metrics
    params:
      password:
        - YourIPCPassword
    static_configs:
      - στόχοι:
          - 127. .0.1:1242

Φυσικά, πρέπει να διασφαλίσετε ότι η παρουσία σας φιλοξενείται Prometheus είναι σε θέση να φτάσει στη διεπαφή IPC του ASF, προσαρμόζει αναλόγως τους «κωδικούς» και τους «στόχους» στη χρήση σας. Εάν δεν έχετε ορίσει κωδικό πρόσβασης IPC (το οποίο δεν συνιστάται), μπορείτε να παραλείψετε την προσθήκη της ενότητας params. Σε περίπτωση που εκτελείτε πολλαπλές παρουσίες ASF με διαφορετικούς κωδικούς πρόσβασης IPC, μπορείτε να προσθέσετε πρόσθετες ρυθμίσεις απόξεσης, ένα ανά παράδειγμα, καθώς οι παράμετροι του ερωτήματος δεν μπορούν να οριστούν ανά στόχο. Διαφορετικά, μπορείτε να δηλώσετε αρκετούς targets αν έχουν τον ίδιο κωδικό πρόσβασης.

---

Πίνακας εργαλείων Grafana

Once your metrics are gathered by Prometheus, it's possible to use Grafana for visualization. Το plugin έρχεται με /grafana-ταμπλό. son αρχείο που εξυπηρετείται από τυπικούς μηχανισμούς IPC, οπότε υποθέτοντας ότι εκτελείτε την παρουσία σας ASF με προεπιλεγμένες ρυθμίσεις, μπορείτε να το κατεβάσετε here. Alternatively, you can also grab the JSON file from our repository as well.

---

Prometheus, Grafana ταμπλό και μετρικές σύστημα διαφυγής

Το ASF υποστηρίζει διάφορα σχήματα διαφυγής από το V6.3.8.4, με ενοποιημένη και ολοκληρωμένη λύση ξεκινώντας από το V6.3.9.4 (ως μέρος του #3607).

Δυστυχώς, αυτό προκαλεί ένα μικρό ζήτημα σε σχέση με το ταμπλό της Grafana, αφού για να λειτουργήσει χρειάζεστε ακριβή μετρικά ονόματα όπως αναλύεται από τον Προμηθέα, και αυτό το λογισμικό συμπεριφέρεται με δύο διαφορετικούς τρόπους από προεπιλογή ανάλογα με το αν χρησιμοποιείτε V2. ή V3.x έκδοση της. Δείτε UTF-8 Prometheus docs για περισσότερες πληροφορίες.

Ενώ περιμένουμε τον Prometheus V3.x να υιοθετηθεί ευρέως (με την debian σταθερή ως τρέχουσα κατευθυντήρια γραμμή), συνιστούμε προσέγγιση της κληρονομιάς, δηλαδή:

• Ο πίνακας ελέγχου Grafana έρχεται με υπογράμμιση ονομάτων από προεπιλογή, τα οποία αναγνωρίζονται από τον Προμηθέα V2.x
• Χρησιμοποιήστε το metric_name_escaping_scheme: underscores ως μέρος του ASF scrape config (όπως στο παράδειγμα παραπάνω), αν χρησιμοποιείτε το Prometheus V3.x

Αυτό συμβαίνει επειδή, ενώ ο Προμηθέας V3.x μπορεί εύκολα να ρυθμιστεί ώστε να χρησιμοποιεί την προσέγγιση του παλαιού τύπου, Προμηθέας V2. δεν έχει τέτοια επιλογή για εργασία ώστε να εξαναγκάσει το νέο να χρησιμοποιηθεί.

Στο μέλλον, πιθανότατα θα αναπαράγουμε τον πίνακα εργαλείων Grafana για να χρησιμοποιήσουμε τις νέες προτεινόμενες προεπιλογές, και η ρύθμιση δεν θα απαιτείται πλέον. Σήμερα αυτό θα προκαλέσει προβλήματα για τους παλαιότερους χρήστες Prometheus, η οποία δεν είναι δικαιολογημένη.

Φυσικά, το plugin στο ίδιο το ASF υποστηρίζει όλες τις διαφορετικές επιλογές μορφοποίησης, ώστε να μπορείτε πάντα να επιλέξετε αυτό που σας αρέσει και να προσαρμόσετε τον πίνακα εργαλείων Grafana στον εαυτό σας - απλά το κάνουμε ευκολότερο για εσάς με μια απλή σύσταση αλλαγής διαμόρφωσης μιας γραμμής.