Recupera metriche in tempo reale dalle tue istanze

Questa documentazione fa parte della guida Monitora le tue istanze. Consulta la guida completa qui: Come ottenere metriche in tempo reale in formato Prometheus dalle tue istanze Stackhero.

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!