Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Il recapito dei log serverless scrive i log applicativi da job serverless su un volume di Unity Catalog. Gli amministratori dello spazio di lavoro configurano una destinazione per lo spazio di lavoro in modo che i team possano conservare i log e processarli con i loro strumenti di osservabilità. I log vengono consegnati in modo asincrono dopo il completamento del lavoro. La consegna può richiedere diversi minuti e varia in base ai tempi di elaborazione e caricamento.
Important
Questa funzionalità è in versione beta. Per utilizzarlo, un amministratore dello spazio di lavoro deve attivare la consegna di log serverless ai volumi di Unity Catalog dalla pagina delle anteprime. Vedere Gestire le anteprime di Azure Databricks.
Requirements
- Uno spazio di lavoro con calcolo serverless e Unity Catalog abilitati.
- Serverless versione dell'ambiente 5 o successiva.
- Il ruolo di amministratore dello spazio di lavoro è necessario per configurare la consegna dei log. Consulta Assegnare il ruolo di amministratore dello spazio di lavoro a un utente.
- L'anteprima della consegna di log serverless ai volumi di Unity Catalog è abilitata per lo spazio di lavoro. Potrebbe essere già abilitato. Se è disabilitato, un amministratore dello spazio di lavoro può attivarlo nella pagina delle anteprime. Abilitare l'anteprima rende disponibile la configurazione; non avvia la consegna.
- Un volume di destinazione. L'amministratore che configura la consegna necessita di
USE CATALOGsul proprio catalogo,USE SCHEMAsul suo schema eREAD VOLUMEeWRITE VOLUMEsul volume. Vedere Privilegi per i volumi del catalogo Unity.
Note
Configura la consegna solo a un'unità attendibile con accesso limitato. I log consegnati possono contenere informazioni sensibili, inclusi email degli utenti, percorsi di archiviazione, tracce dello stack, identificatori interni e URL firmati temporanei. I log non sono garantiti come privi di informazioni sensibili.
Gli utenti con accesso alla destinazione possono leggere i log consegnati, inclusi quelli dei lavori di altri utenti. Limita l'accesso al volume di conseguenza.
Limitations
La consegna di log serverless supporta solo i job serverless. Non supporta pipeline Lakeflow né notebook interattivi.
Abilita la consegna dei log
Un amministratore dello spazio di lavoro deve abilitare la consegna dei log per lo spazio di lavoro.
- Apri impostazioni dal menu utente.
- In Amministratore area di lavoro, fai clic su Compute.
- Nella sezione Consegna log, attiva Consegna log serverless.
-
Configura consegna dei log, inserisci un percorso del volume, come
/Volumes/observability/production/serverless_logs, oppure clicca sull'icona della cartella per sfogliare i volumi. - Fare clic su Salva. Salvare la destinazione consente la consegna.
L'impostazione si applica a livello di spazio di lavoro. Non è necessario configurare ogni lavoro separatamente.
Visualizza i log recapitati
L'output applicativo comprende output standard ed errori standard dal codice utente, incluse le funzioni definite dall'utente (UDF). Usa Catalog Explorer per navigare nel volume di destinazione e ispezionare i file consegnati. Consultare Usare i file nei volumi del catalogo Unity.
La consegna dei log non fornisce metriche di cluster o profili di query. Usa la pagina di esecuzione del processo per analizzare lo stato di esecuzione e le prestazioni insieme ai log dell'applicazione. Vedere Monitorare i processi Lakeflow.
Query delivered log con SQL
Usa read_files per interrogare i file di testo consegnati. Sostituisci il percorso del volume in questo esempio con la tua destinazione. Per leggere i log, sono necessari USE CATALOG per il catalogo, USE SCHEMA per lo schema e READ VOLUME per il volume.
Crea una vista temporanea che estragga gli identificatori di job e run dal percorso del file e conserva ogni riga di output log:
CREATE OR REPLACE TEMPORARY VIEW serverless_job_logs AS
SELECT
regexp_extract(_metadata.file_path, '/job_id=([^/]+)/', 1) AS job_id,
regexp_extract(_metadata.file_path, '/job_run_id=([^/]+)/', 1) AS job_run_id,
regexp_extract(_metadata.file_path, '/task_run_id=([^/]+)/', 1) AS task_run_id,
_metadata.file_name AS file_name,
value AS log_line
FROM read_files(
'/Volumes/observability/production/serverless_logs/',
format => 'text'
);
Trova le righe contenenti errori tra le esecuzioni dei lavori:
SELECT job_id, job_run_id, task_run_id, file_name, log_line
FROM serverless_job_logs
WHERE log_line LIKE '%ERROR%';
Identifica i lavori con il maggior numero di linee di errore:
SELECT
job_id,
count(*) AS error_lines,
count(DISTINCT job_run_id) AS affected_runs
FROM serverless_job_logs
WHERE log_line LIKE '%ERROR%'
GROUP BY job_id
ORDER BY error_lines DESC;
Queste query cercano il testo ERRORletterale . Regola il filtro per adattarlo al formato di logging della tua applicazione. Vedere read_files funzione con valori di tabella.
Cambia la destinazione o disabilita la consegna
Per cambiare la destinazione, apri Impostazioni > Compute > Recapito log, clicca sull'icona a matita accanto al nome del volume, inserisci o naviga su un nuovo percorso e clicca su Salva. Salvare una destinazione consente la consegna, incluso quando la consegna è stata disabilitata.
Per disabilitare la consegna, apri Impostazioni > Compute > Log delivery e disattiva la consegna dei log serverless. L'impostazione mantiene la destinazione così puoi riabilitare la consegna senza selezionare un altro volume. Disabilitare la consegna non rimuove i file già scritti nel volume di archiviazione. Gestisci l'accesso e la conservazione di quei file separatamente.
Risoluzione dei problemi relativi ai log mancanti
Se i log non compaiono dopo il completamento del lavoro:
- Controlla che la consegna di log serverless sia abilitata sotto Impostazioni > Compute > Consegna log. L'abilitazione della sola anteprima non avvia la consegna.
- Verifica che il volume configurato esista e che l'amministratore che ha configurato la consegna mantenga i permessi richiesti.
- Conferma che il lavoro utilizza calcolo serverless e produce output applicativo. Attendere alcuni minuti dopo il completamento del processo per la consegna asincrona. I tempi di elaborazione e caricamento possono ritardare la consegna.
Per la consegna classica dei log di compute, vedi Consegna dei log di compute.