Questo documento descrive come creare e gestire gli ambiti di log, che puoi utilizzare per trovare in modo efficiente le voci di log che vuoi da visualizzare o analizzare. Se vuoi visualizzare e analizzare solo le voci di log che hanno origine in un progetto, in una cartella o in un'organizzazione, questo documento non è te. Tuttavia, se fai affidamento sink di log a cui instradare i log in altri progetti o in bucket di log definiti dall'utente o, se utilizzi le visualizzazioni di log, le informazioni in questo documento può aiutarti a trovare in modo efficiente voci di log specifiche.
Questo documento non descrive come visualizzare i log. Per informazioni su questo argomento, vedi Visualizza i log utilizzando Esplora log.
Informazioni sugli ambiti dei log
Gli ambiti di log sono risorse permanenti a livello di progetto che elencano un set di risorse per cercare le voci di log. Un ambito di log può includere progetti, cartelle, organizzazioni e viste di log. Ad esempio, puoi definire un ambito di log che elenca i progetti che contengono risorse utilizzate per la produzione o che elenca le viste log che includono voci di log per un tipo di risorsa specifico.
Quando crei un progetto, una cartella o una risorsa dell'organizzazione Google Cloud,
Logging crea un ambito di log denominato _Default.
Questo ambito include il progetto, la cartella o l'organizzazione che è stata creata.
I risultati di una ricerca di queste risorse includono le voci di log che
provengono dalla risorsa, sono archiviati in un bucket di log.
Per i progetti, i risultati di ricerca includono anche voci di log
instradate al progetto da un sink in un altro progetto
e quindi archiviato in un bucket di log.
Puoi creare ambiti di log. Puoi anche modificare ed eliminare
gli ambiti di log che crei. Tuttavia, non puoi
modifica o elimina l'ambito dei log denominato _Default.
Per i progetti, l'ambito di log predefinito determina l'insieme di risorse
che la pagina Esplora log esegue la ricerca all'apertura. Tuttavia,
i ruoli IAM (Identity and Access Management) per le risorse cercate e
l'impostazione dell'intervallo di tempo determina quali voci di log vengono recuperate dallo spazio di archiviazione.
Quando vengono creati i progetti, viene designato l'ambito dei log denominato _Default
predefinito come ambito di log. Puoi impostare l'ambito dei log
predefinito nell'ambito dei log.
Best practice
Poiché gli ambiti di log consentono di definire e salvare un per uso futuro, ti consigliamo di creare ambiti di log per configurazioni di ricerca complesse.
Ad esempio, supponiamo che tu stia risolvendo un problema e voglia visualizzare il voci di log per tutte le istanze di macchine virtuali (VM) di proprietà del tuo team. Per eseguire questa operazione:
Sei tu a stabilire che le voci di log che vuoi visualizzare sono archiviate in in più bucket di log e in più progetti. Per la maggior parte dei bucket di log, esiste una visualizzazione di log che include le voci di log da analizzare. Se non esiste una visualizzazione del log, puoi crearne una.
Decidi di creare un ambito di log perché prevedi di avere un'attività di risoluzione dei problemi simile in futuro.
Apri la pagina Esplora log nella console Google Cloud. e poi utilizza il menu Perfeziona ambito per selezionare la nuova nell'ambito dei log.
Esamini le voci di log e trovi le informazioni da risolvere il problema che stavi esaminando.
Una volta risolto il problema, condividi la causa con il tuo colleghi. Condividi inoltre che prevedi di riscontrare errori simili nei hai creato un ambito di log che consente a te o a chiunque indaga sull'errore, trova rapidamente le voci di log pertinenti.
Limitazioni
- Non puoi eliminare o modificare l'ambito dei log denominato
_Default. - Solo i progetti Google Cloud supportano un ambito di log predefinito.
- Non puoi aggiungere cartelle o organizzazioni a un ambito di log definito dall'utente.
- Non è previsto il supporto dell'API Cloud Logging o di Google Cloud CLI per la creazione o per gestire gli ambiti dei log.
Prima di iniziare
Per ottenere le autorizzazioni necessarie per creare e visualizzare gli ambiti di log e per impostare l'ambito di log predefinito, chiedi all'amministratore di concederti seguenti ruoli IAM:
-
Per creare e visualizzare gli ambiti dei log:
Writer configurazione log (
roles/logging.configWriter) nel progetto, nella cartella o nell'organizzazione -
Per impostare l'ambito dei log predefinito:
Observability Editor (
roles/observability.editor) nel progetto, nella cartella o nell'organizzazione
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.
Questi ruoli predefiniti le autorizzazioni necessarie per creare e visualizzare gli ambiti di log e impostare l'ambito di log predefinito. Per vedere le autorizzazioni esatte obbligatorie, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per creare e visualizzare gli ambiti di log e per impostare l'ambito di log predefinito, sono necessarie le seguenti autorizzazioni:
-
Per impostare l'ambito dei log predefinito:
observability.scopes.[get, update] -
Per creare e gestire gli ambiti dei log:
logging.logScopes.[create, delete, get, list, update]
Potresti anche riuscire a ottenere queste autorizzazioni con ruoli personalizzati altri ruoli predefiniti.
Elenca ambiti di log
Per elencare gli ambiti dei log:
-
Nella console Google Cloud, vai alla settings Pagina Impostazioni:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
Seleziona la scheda Ambiti di log.
Nella tabella sono elencati gli ambiti dei log. Dopo aver selezionato un progetto Google Cloud, una voce della tabella è annotata con un'icona etichettata
Default, che indica che L'ambito dei log elenca le risorse che Esplora log effettua una ricerca quando la pagina viene aperta.
Imposta l'ambito dei log predefinito
L'ambito dei log predefinito elenca le risorse cercate dall' Esplora log all'apertura di quella pagina. Se l'ambito di log predefinito non esiste o non è accessibile, la pagina cerca automaticamente le voci di log che hanno origine il progetto, la cartella o l'organizzazione selezionati. Le voci di log visualizzate nella pagina Esplora log dipendono da le risorse cercate, l'impostazione dell'intervallo di tempo e i ruoli IAM ruoli sulle risorse oggetto della ricerca.
Alla creazione dei progetti, viene creato l'ambito di log denominato _Default
ed è designato come ambito di log predefinito. Tuttavia, puoi creare
l'ambito dei log tuo e impostalo come ambito di log predefinito.
Per impostare l'ambito di log predefinito, segui questi passaggi:
-
Nella console Google Cloud, vai alla settings Pagina Impostazioni:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
- Seleziona la scheda Ambiti di log.
Trova l'ambito dei log da designare come ambito nell'ambito dei log predefinito, fai clic su more_vert Altro, e seleziona Imposta come predefinita.
L'ambito di log selezionato è annotato con un'icona etichettata
Default.
Crea un ambito di log
Puoi creare 100 ambiti di log per progetto. Un ambito di log può includere un totale di 100 viste di log e progetti; ma può includere solo 50 progetti. Non puoi aggiungere cartelle o organizzazioni in un ambito di log.
Per creare un ambito di log, segui questi passaggi:
-
Nella console Google Cloud, vai alla settings Pagina Impostazioni:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
- Seleziona la scheda Ambiti log e quindi fai clic su Crea ambito log.
Per aggiungere uno o più progetti, fai clic su Aggiungi progetti e completa la .
Dopo aver aggiunto un progetto, i tuoi ruoli IAM su quel progetto determinare quali voci di log puoi visualizzare. Ad esempio, il ruolo IAM potrebbe consentirti di visualizzare solo le voci di log che sono accessibili da una vista di log specifica in un bucket di log. Per ulteriori informazioni informazioni sui ruoli, consulta Ruoli di logging.
Per aggiungere una o più visualizzazioni log, fai clic su Aggiungi visualizzazioni log e completa la .
La finestra di dialogo elenca tutte le visualizzazioni di log con voci di log che hanno origine al progetto attuale o che sono stati indirizzati al progetto attuale da un in un altro progetto. Ad esempio, se non hai configurato alcun sink, questa finestra di dialogo elenca le visualizzazioni log del progetto corrente.
Per elencare le visualizzazioni dei log archiviate in un altro progetto Google Cloud, fai clic su add_circle Importa progetto e seleziona a livello di progetto Google Cloud.
Dopo aver aggiunto una visualizzazione log, i tuoi ruoli IAM nell'interfaccia visualizzazione del log o il progetto che archivia la visualizzazione del log determinare a quali voci di log puoi accedere. Per ulteriori informazioni, vedi Controllare l'accesso a una visualizzazione del log.
Nella sezione Ambito log dei nomi, inserisci il nome e la descrizione che vuoi visualizzare nella scheda Ambiti log.
Il nome di un ambito di log non può essere modificato e deve essere univoco all'interno del progetto.
Fai clic su Applica.
Modificare o eliminare un ambito di log
Per modificare o eliminare un ambito di log creato da te o da un collega, procedi nel seguente modo:
-
Nella console Google Cloud, vai alla settings Pagina Impostazioni:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
- Seleziona la scheda Ambiti di log.
Trova gli ambiti di log da modificare o eliminare. fai clic su more_vert Altro, quindi effettua una delle seguenti operazioni:
- Per apportare modifiche, seleziona Modifica ambito, poi completa la finestra di dialogo.
- Per eseguire l'eliminazione, seleziona Elimina ambito, quindi completa la finestra di dialogo.