Progetto, servizio, ambiente
Configura un progetto
Installa la CLI. Eseguilogbrew status --json per leggere
l’accesso del tuo account. Se l’accesso non è valido, una persona esegue
logbrew login. Una chiave di ingestione del progetto non può farti accedere.
1
Crea o seleziona un progetto
Prima elenca i tuoi progetti. Crea un progetto solo se non esiste.La CLI scrive la chiave di ingestione in un nuovo file leggibile solo dal
proprietario. Non stampa mai la chiave né il percorso del file. Se il
risultato non è chiaro, esegui di nuovo esattamente lo stesso comando. Non
cambiare il nome del progetto né il file della chiave. La CLI riusa
l’identità della richiesta in sospeso. La guida rapida
mostra come leggere l’ID del progetto dal risultato.Per un progetto esistente, registra lo stato della configurazione:Per creare un’altra chiave di ingestione per un progetto esistente, usa
logbrew projects keys create. La
guida alla rotazione della chiave di ingestione
mostra il comando.logbrew setup --create-project mostra solo l’aiuto. Non crea un
progetto.2
Imposta i nomi dei servizi nell'SDK
Usa nomi presi dal tuo repository e dal tuo deploy, come
api, worker,
web, ios o checkout-api. Il nome di un servizio è un’etichetta, non
seleziona il progetto. È la chiave di ingestione a selezionare il
progetto. Rinominare un servizio non sposta gli eventi memorizzati. Se non
trovi un evento, controlla il progetto e la chiave di ingestione che
l’applicazione usa prima di creare un altro progetto.3
Usa ambienti standard
Usa
production, staging, preview e local. Se il tuo deploy usa
altri nomi, usali in modo coerente. Il nome di un ambiente non può
contenere spazi, / o una barra rovesciata.4
Invia un evento di test e leggilo
Configura l’SDK con la chiave di ingestione del progetto, come descrive la
guida all’integrazione SDK. Creare un
progetto non installa un SDK nella tua applicazione. Tieni la chiave fuori
dal controllo di versione. Imposta servizio, ambiente e release
nell’applicazione. Invia un evento sicuro, poi leggilo:Ogni segnale ha un proprio elenco. Un elenco di log vuoto non significa che
il progetto non abbia problemi o tracce.Nella dashboard, seleziona lo stesso progetto e un intervallo di tempo che
includa l’evento di test. Verifica che i filtri per servizio, ambiente e
release corrispondano all’evento.
Diagnostica la configurazione del progetto
Leggi lo stato della configurazione con la diagnostica del progetto. Non dedurre lo stato della configurazione da file locali o da una query sui log vuota.status, checks e next. Il codice di
uscita 0 non indica che tutti i controlli siano riusciti. Leggi ogni
elemento di checks. Consulta
Leggi il report di diagnostica di un progetto.
Risposta diretta dell’API
I client API chiamanoGET /api/projects/{project_id}/doctor con
l’autenticazione dell’account. L’endpoint non ha parametri di query né corpo
della richiesta. Non usare mai una chiave di ingestione del progetto per
questa lettura.
Una risposta 200 ha queste chiavi: project_id, state, setup_status,
setup_acknowledged, has_active_ingest_key, first_telemetry_seen_at,
last_seen_at, last_signal, next e next_action. I timestamp sono in
formato RFC3339 oppure null. last_signal è un riepilogo sicuro da
mostrare, non un segnale grezzo.
La diagnostica controlla prima la chiave di ingestione. Un progetto senza una
chiave di ingestione attiva è
needs_ingest_key, qualunque sia lo stato della
configurazione.
setup_status vale created, setup_started, sdk_seen,
first_telemetry_seen o active. setup_acknowledged è true solo per gli
ultimi tre valori. created dà needs_setup. setup_started e sdk_seen
danno needs_telemetry. first_telemetry_seen e active danno ready.
Se la lettura continua a non riuscire,
invia una segnalazione. Non includere
credenziali, header, corpi dei segnali, dati dei clienti, percorsi locali o
codice sorgente.
Archivia o elimina un progetto
Archivia un progetto per toglierlo dall’elenco dei progetti attivi:--yes. Dopo l’archiviazione, le chiavi di ingestione del
progetto smettono di accettare nuova telemetria. La route dell’API è
DELETE /api/projects/{project_id}. Restituisce 204 senza corpo. Elenca i
progetti archiviati con GET /api/projects/archived. Ripristinane uno con
POST /api/projects/{project_id}/restore, che restituisce anch’esso 204.
Elimina un progetto in modo definitivo solo se ne hai la certezza:
--confirm. Una richiesta accettata
rende subito inattivo il progetto e pianifica l’eliminazione definitiva. Dopo,
non puoi più ripristinare il progetto.