Profilazione continua

La profilazione continua mostra come la vostra applicazione spende tempo CPU e memoria, funzione per funzione. Status200 espone un'API di acquisizione compatibile con Pyroscope, quindi tutto ciò che può inviare dati a un server Pyroscope (il profiler eBPF di Grafana Alloy o un SDK Pyroscope per il vostro linguaggio) può inviarli a Status200, e leggete il risultato come flame graph accanto a log, metriche e tracce.

Come funziona#

Un profiler campiona i vostri processi e carica un profilo ogni pochi secondi sull'endpoint /pyroscope di Status200, con la vostra chiave di acquisizione. Status200 memorizza ogni profilo sotto il servizio che indica e lo disegna come flame graph in Profili di prestazioni.

Prima di iniziare#

Vi serve una chiave di acquisizione della telemetria di tipo Server. Se non ne avete ancora una:

1. Aprire le chiavi di acquisizione#

   Andate in Prodotti → Impostazioni del progetto, aprite Telemetria e APM nel menu laterale e selezionate Chiavi di acquisizione.

   

2. Creare una chiave#

   Fate clic su Crea chiave di ingestione. La finestra di dialogo ha già il nome della chiave compilato e Server selezionato (il tipo di chiave con cui invia un'applicazione o un collector), quindi fate clic su Crea chiave di ingestione per crearla, oppure rinominatela prima.

3. Copiare il segreto#

   La nuova chiave si apre nella sua pagina. Copiatene la Chiave segreta: è il token di acquisizione che gli esempi qui sotto chiamano YOUR_STATUS200_INGESTION_TOKEN.

   

Endpoint di acquisizione#

I client aggiungono il proprio percorso all'URL di base (/ingest per la maggior parte degli SDK Pyroscope, /push.v1.PusherService/Push per Grafana Alloy e per l'SDK .NET da v0.14), quindi configurate sempre solo l'URL di base, senza barra finale.

Status200 legge il token di acquisizione da una qualsiasi di queste fonti; usate quella supportata dal vostro client:

Formati di profilo supportati#

Inviare i profili#

Grafana Alloy profila ogni processo di un host senza modifiche al codice ed è il modo consigliato per iniziare. Un SDK Pyroscope, invece, gira all'interno della vostra applicazione.

discovery.process "all" {
  refresh_interval = "60s"
}

discovery.relabel "alloy_profiles" {
  targets = discovery.process.all.targets

  rule {
    action       = "replace"
    source_labels = ["__meta_process_exe"]
    target_label  = "service_name"
  }
}

pyroscope.ebpf "default" {
  targets    = discovery.relabel.alloy_profiles.output
  forward_to = [pyroscope.write.status200.receiver]

  collect_interval = "15s"
  sample_rate      = 97
}

pyroscope.write "oneuptime" {
  endpoint {
    url = "https://status200.ru/pyroscope"
    headers = {
      "x-status200-token" = "YOUR_STATUS200_INGESTION_TOKEN",
    }
  }
}

services:
  alloy:
    image: grafana/alloy:latest
    privileged: true
    pid: host
    volumes:
      - ./alloy-config.alloy:/etc/alloy/config.alloy
      - /proc:/proc:ro
      - /sys:/sys:ro
    command:
      - run
      - /etc/alloy/config.alloy

alloy run alloy-config.alloy

import "github.com/grafana/pyroscope-go"

pyroscope.Start(pyroscope.Config{
    ApplicationName: "my-service",
    ServerAddress:   "https://status200.ru/pyroscope",
    AuthToken:       "YOUR_STATUS200_INGESTION_TOKEN",
    ProfileTypes: []pyroscope.ProfileType{
        pyroscope.ProfileCPU,
        pyroscope.ProfileAllocObjects,
        pyroscope.ProfileAllocSpace,
        pyroscope.ProfileInuseObjects,
        pyroscope.ProfileInuseSpace,
        pyroscope.ProfileGoroutines,
    },
})

const Pyroscope = require("@pyroscope/nodejs");

Pyroscope.init({
  serverAddress: "https://status200.ru/pyroscope",
  appName: "my-service",
  authToken: "YOUR_STATUS200_INGESTION_TOKEN",
});

Pyroscope.start();

import pyroscope

pyroscope.configure(
    application_name="my-service",
    server_address="https://status200.ru/pyroscope",
    auth_token="YOUR_STATUS200_INGESTION_TOKEN",
)

FROM alpine:3.20 AS pyroscope-profiler
ARG PYROSCOPE_DOTNET_VERSION=1.5.1
ADD https://github.com/grafana/pyroscope-dotnet/releases/download/pyroscope-${PYROSCOPE_DOTNET_VERSION}/pyroscope.${PYROSCOPE_DOTNET_VERSION}-glibc-x86_64.tar.gz /tmp/pyroscope.tar.gz
RUN mkdir -p /pyroscope && tar -xzf /tmp/pyroscope.tar.gz -C /pyroscope

FROM mcr.microsoft.com/dotnet/aspnet:10.0
# ... your application ...
COPY --from=pyroscope-profiler /pyroscope /pyroscope
ENV CORECLR_ENABLE_PROFILING=1
ENV CORECLR_PROFILER={BD1A650D-AC5D-4896-B64F-D6FA25D6B26A}
ENV CORECLR_PROFILER_PATH=/pyroscope/Pyroscope.Profiler.Native.so
ENV LD_PRELOAD=/pyroscope/Pyroscope.Linux.ApiWrapper.x64.so
ENV LD_LIBRARY_PATH=/pyroscope

PYROSCOPE_APPLICATION_NAME=my-service
PYROSCOPE_PROFILING_ENABLED=1
PYROSCOPE_SERVER_ADDRESS=https://status200.ru/pyroscope
PYROSCOPE_BASIC_AUTH_USER=oneuptime
PYROSCOPE_BASIC_AUTH_PASSWORD=YOUR_STATUS200_INGESTION_TOKEN

Ruby e Rust funzionano come Go, Node.js e Python: installate l'SDK Pyroscope per il vostro linguaggio e impostate l'indirizzo del server su https://status200.ru/pyroscope con il vostro token di acquisizione come token di autenticazione (oppure, se la vostra versione dell'SDK offre solo l'autenticazione basic, come password basic).

Tipi di profilo supportati#

Un pprof può dichiarare più tipi di campione; ogni profilo caricato viene memorizzato sotto uno di essi: il tempo CPU (cpu in nanosecondi) se lo ha, altrimenti il tempo reale, altrimenti i byte in uso e poi quelli allocati, altrimenti il primo tipo che dichiara. Qualsiasi tipo viene memorizzato e si può consultare; i tipi seguenti hanno raggruppamento, unità ed etichette dedicati in Status200:

Tutto il resto (per esempio un tipo di campione personalizzato) compare in «Altro» con il suo nome originale.

Verificare che funzioni#

1. Controllare il token#

   Gli endpoint di acquisizione rispondono 401 a un token mancante o non valido, ma la maggior parte dei profiler non lo mostra da nessuna parte dove lo vedreste (il profiler .NET, per esempio, registra le risposte HTTP solo a livello debug). Interrogate direttamente l'endpoint di convalida:

   Bash

   curl -i -H "x-status200-token: YOUR_STATUS200_INGESTION_TOKEN" \
     https://status200.ru/otlp/v1/validate

   Un token valido restituisce 200 con {"valid": true, ...}, e il suo keyType deve essere Server: anche una chiave per browser è valida, ma non può inviare profili. Un token sconosciuto, revocato, disattivato o scaduto restituisce 401.

2. Aprire la pagina dei profili#

   Nella dashboard di Status200 andate in Prodotti → Profili di performance. Con l'intervallo di raccolta di 15 secondi di Alloy (o l'intervallo di caricamento degli SDK, da 10 a 15 secondi), i primi profili e i loro flame graph compaiono entro un paio di minuti dall'avvio dell'agente.

3. Controllare il servizio#

   I profili vengono associati al servizio di telemetria indicato da application_name / appName / PYROSCOPE_APPLICATION_NAME dell'SDK (o dal nome dell'eseguibile del processo con la regola di rietichettatura di Alloy vista sopra).

4. Ancora niente? Guardate lo stato dei caricamenti#

   Per il profiler .NET, impostate DD_TRACE_DEBUG=1 sull'applicazione per un minuto: registrerà una riga PyroscopePprofSink <status> per ogni caricamento. 200 significa che Status200 l'ha accettato; 401 è il token; 404 di solito significa che a PYROSCOPE_SERVER_ADDRESS manca il suffisso /pyroscope; 413 significa che un proxy davanti a Status200 ha rifiutato il caricamento per le sue dimensioni (vedete la scheda .NET in Inviare i profili). Se ospitate Status200 in autonomia, il log di accesso dell'ingress (nginx) registra lo stesso stato per ogni richiesta a /pyroscope.

Esplorare i profili in Status200#

Prodotti → Profili di performance apre il Profiler sulla sua Panoramica. Risponde a parole prima di qualsiasi grafico: dove va il tempo («JSON.parse occupa 42% del totale di tempo CPU in checkout.») e, quando la funzione più impegnata è di una libreria o del runtime, la funzione del vostro codice che occupa di più, con il codice di librerie e runtime che chiama. In alto, scegliete un servizio, un tipo di profilo per cui ha dati (Tempo CPU, Tempo reale, Memoria, Allocazioni, Lock o Goroutines, oppure un tipo in Altri tipi di profilo) e un intervallo.

Confrontare due intervalli#

Confronta con stabilisce con cosa viene confrontato l'intervallo: Il periodo precedente, La stessa ora di ieri, La stessa ora della settimana scorsa, oppure un deploy in Prima e dopo una modifica. Si confrontano le quote, non i totali, quindi più traffico da solo non sposta nulla. Il titolo nomina la funzione la cui quota è cresciuta di più, e il vostro codice che è cresciuto; il flame graph diventa Cosa è cambiato, dove i frame rossi occupano una quota maggiore dopo e quelli verdi una minore; e Funzioni cambiate elenca la quota di ogni funzione prima e dopo.

Una funzione#

Fate clic su una funzione per aprirne il pannello: la sua quota come Proprio, Totale e Il tuo codice, Chi la chiama e Cosa chiama, un link al suo file e alla sua riga nel vostro repository quando ne è collegato uno, e Evidenzia nel flame graph. Per una funzione di una libreria o del runtime, il pannello nomina la funzione del vostro codice che la chiama, dove una modifica può renderla più economica. Un link sotto le quote imposta un avviso sulla quota della funzione, sopra quanto occupa oggi: vedete Monitor profili.

Quando una funzione del vostro codice occupa almeno il 5% del tempo o della memoria del profilo, o la sua quota è cresciuta di 3 punti o più rispetto all'intervallo con cui è confrontata, il pannello offre Correggi con l'IA: Status200 AI avvia un'attività nel repository che contiene la funzione, con il profilo come prova, e apre una pull request da rivedere (vedete Code). Status200 AI legge i profili anche nelle sue risposte e nelle indagini, quindi potete chiedergli quali funzioni usano più tempo CPU.

Un singolo profilo#

Tutti i profili elenca ogni caricamento. La pagina di un profilo ha tre viste:

Download pprof salva il profilo per strumenti locali come go tool pprof.

Correlazione con le tracce#

Quando un profilo contiene ID di traccia e di span (per esempio come etichette di campione trace_id / span_id), potete passare direttamente da uno span lento di una traccia al profilo CPU o di memoria corrispondente per capire esattamente quale codice era in esecuzione, e Open linked trace fa il percorso inverso.

La scheda Profilo di uno span include anche i campioni collegati agli span annidati sotto di esso, perché i profiler spesso attribuiscono il tempo CPU di una richiesta a uno span figlio anziché allo span della richiesta stessa.

La pagina di una traccia rimanda anche al Profiler sul servizio della traccia, per i 15 minuti prima e dopo, quando quel servizio era profilato in quel momento, e la pagina Profili di prestazioni di un servizio o di un host apre il Profiler su quel servizio o host.

Conservazione dei dati#

I profili vengono conservati per la durata della conservazione della telemetria del vostro progetto: Impostazioni del progetto → Telemetria e APM → Conservazione dei dati imposta la Conservazione predefinita (giorni), 15 giorni se non la cambiate. I dati vengono eliminati automaticamente alla fine del periodo di conservazione. I piani che includono eccezioni alla conservazione possono anche tenere i profili più o meno a lungo rispetto al resto della telemetria, o impostare la conservazione per singolo servizio nella pagina Impostazioni del servizio.

Passaggi successivi#