Monitora le tue istanze

Come ottenere metriche in tempo reale in formato Prometheus dalle tue istanze Stackhero

Introduzione

Stackhero ti aiuta a recuperare metriche in tempo reale dalle tue istanze in formato Prometheus. Questa integrazione senza soluzione di continuità facilita la visualizzazione dei dati con le dashboard di Grafana e l'attivazione di avvisi tramite Prometheus (via email, SMS, Slack, Mattermost e altro) per tutti i tuoi servizi Stackhero in pochi minuti.

Dashboard Grafana che mostra un'istanza in tempo reale

Come funzionano le metriche Prometheus su Stackhero

Stackhero fornisce un endpoint HTTP di "Service Discovery" che restituisce metriche in tempo reale dalle tue istanze in formato Prometheus.

Ecco il quadro generale:

1. Il tuo server Prometheus si connette ogni 15 secondi all'API di Stackhero per recuperare metriche in tempo reale dalle tue istanze.
2. Il tuo server Prometheus attiva avvisi utilizzando Alert Manager quando le condizioni definite sono soddisfatte.
3. Il tuo server Grafana si connette al tuo server Prometheus per visualizzare dashboard che mostrano le tue istanze Stackhero.

Recupera metriche in tempo reale dalle tue istanze

1. Crea un token

Per iniziare, devi generare un token che il tuo server Prometheus possa utilizzare per connettersi all'API di Stackhero.

• Accedi alla tua dashboard Stackhero.
• Nel menu a sinistra, naviga fino a Prometheus.
• Clicca su Crea un token.
• Aggiungi una descrizione e, se necessario, limita l'accesso IP (lascia 0.0.0.0/0 per consentire qualsiasi IP).
• Copia la configurazione Prometheus generata.

Creazione del token Prometheus nella dashboard Stackhero

2. Configura il tuo Prometheus

Non hai ancora un server Prometheus? Con Stackhero puoi avviare un Prometheus gestito in soli 2 minuti!

Apri il tuo file di configurazione prometheus.yml e aggiungi il job "stackhero" (precedentemente generato) alla fine del file.

Ecco un esempio di configurazione:

  - job_name: "stackhero"
    scheme: "https"
    basic_auth:
      username: "<ORGANIZATION_ID>"
      password: "<TOKEN>"
    http_sd_configs:
    - url: "https://api.stackhero.io/v1/prometheus/targets"
      refresh_interval: "15s" # Non impostarlo a meno di 15 secondi!
      basic_auth:
        username: "<ORGANIZATION_ID>"
        password: "<TOKEN>"

3. Verifica che Prometheus recuperi le metriche

Naviga alla tua dashboard Prometheus e vai su Status > Service Discovery. Dovresti vedere un'entrata di service discovery "stackhero" registrata.

Dashboard Prometheus che mostra il service discovery Stackhero

Successivamente, vai su Status > Targets. Dovresti vedere un endpoint per ogni istanza Stackhero.

Dashboard Prometheus che mostra i target Stackhero

Congratulazioni! Il tuo server Prometheus ora recupera automaticamente metriche in tempo reale per tutti i tuoi servizi.

4. Aggiungi una dashboard Grafana (opzionale)

Non hai ancora un server Grafana? Con Stackhero puoi avviare un Grafana gestito in soli 2 minuti!

Puoi sfruttare una dashboard preconfigurata in Grafana per visualizzare le metriche delle tue istanze.

1. Nell'interfaccia web di Grafana, vai su Create > Import.
2. Nella sezione Import via grafana.com, imposta l'ID su 1860 e clicca sul pulsante Load.
3. Nella pagina successiva, seleziona la tua fonte dati Prometheus e clicca su Import.

Grafana genererà una dashboard che visualizzerà istantaneamente i dati recuperati da Prometheus!

Dashboard Grafana che mostra un'istanza in tempo reale

In alto a sinistra dello schermo puoi scegliere l'istanza che vuoi visualizzare cliccando sulla lista host.

Selezione di un'istanza nella lista "host"

Congratulazioni, ora puoi monitorare tutte le tue istanze in tempo reale!