Documentazione di Oracle Cloud Infrastructure

Creazione di un log

Creare un log contenente informazioni di diagnostica critiche che indichi le modalità di esecuzione e accesso ai servizi Oracle Cloud Infrastructure (OCI).

I gruppi di log sono contenitori logici per l'organizzazione dei log. I log devono essere sempre inclusi nei gruppi di log. Prima di creare un log è necessario creare un gruppo di log.

Per ulteriori informazioni sui log e sulle autorizzazioni necessarie per utilizzarli, vedere Gestione dei gruppi di log.

    1. Aprire il menu di navigazione e selezionare Osservabilità e gestione. In Log, selezionare Log.
    2. Selezionare un compartimento nel quale si è autorizzati a lavorare.
    3. Selezionare Crea log personalizzato.
    4. Nella pagina Crea log personalizzato immettere un nome per il log personalizzato. Evitare di inserire informazioni riservate.
    5. Selezionare il compartimento in cui si desidera creare il login.
    6. In Gruppo di log, selezionare un gruppo di log esistente in cui inserire il login personalizzato oppure crearne uno.
    7. (Facoltativo) Nella sezione Tag aggiungere una o più tag al log.

      Se si dispone delle autorizzazioni per creare una risorsa, si dispone anche delle autorizzazioni per applicare tag in formato libero a tale risorsa. Per applicare una tag defined, è necessario disporre delle autorizzazioni per utilizzare la tag namespace. Per ulteriori informazioni sull'applicazione di tag, vedere Tag risorsa. Se non sei sicuro di applicare i tag, salta questa opzione o chiedi a un amministratore. È possibile applicare le tag in un secondo momento.

    8. Selezionare Mostra opzioni aggiuntive, quindi selezionare per quanto tempo conservare il log, con incrementi di 30 giorni, fino a un massimo di 180 giorni:
      Nota

      Se si modifica il periodo di conservazione da sei mesi a un mese, tutti i log più vecchi di un mese non saranno più accessibili. Ad esempio, se si passa da un mese a sei mesi, i log non saranno disponibili dopo un mese e i log vecchi di sei mesi non saranno disponibili.

      Inoltre, l'ora e la data future in cui un log non è più disponibile si basano sull'ora e sulla data esatte in cui è stato creato il log. Ad esempio, se è stato creato un log il 21 luglio alle 15:05 UTC con un periodo di conservazione di tre mesi, il 19 ottobre alle 15:05 il log non sarà più ricercabile.

    9. Selezionare Next.
    10. Nella pagina Crea configurazione agente, creare una nuova configurazione per definire i parametri per i dati di log associati (impostazione predefinita) o aggiungerli in un secondo momento. La configurazione dell'agente definisce le istanze a cui si applica la configurazione (gruppi host), i file di log ottenuti e l'eventuale parser utilizzato (Configura input di log).
      • Se si seleziona Aggiungi nuova configurazione, passare al passo successivo.
      • Se si seleziona Aggiungi configurazione in seguito, passare all'ultimo passo di questo task.
    11. Immettere un nome e una descrizione per la configurazione. Evitare di inserire informazioni riservate.
    12. Selezionare il compartimento in cui si desidera creare la configurazione.
    13. In Gruppi di host, in cui è possibile definire le VM da applicare a questa configurazione, selezionare una delle seguenti opzioni dalla lista Tipo di gruppo:
      • Gruppo dinamico: Gruppo dinamico si riferisce a un gruppo di istanze che è possibile creare nella funzione IAM della console. Per ulteriori informazioni, vedere Informazioni sui gruppi dinamici. Selezionare un gruppo dinamico dalla lista Gruppo.
      • Gruppo di utenti: il gruppo di utenti fa riferimento alla funzione Gruppi IAM della console. Per ulteriori informazioni, vedere Gestione dei gruppi. Selezionare un gruppo di utenti dalla lista Gruppo.
    14. Per aggiungere altri gruppi, selezionare Aggiungi gruppo host.

      È possibile aggiungere una combinazione di tipi di gruppo per la configurazione dell'agente.

      Nota

      È consentito un massimo di cinque gruppi per configurazione e un host può essere incluso in un massimo di cinque gruppi diversi.
    15. In Configurazione agente, definire il formato dei log (quali log si desidera controllare) in Configura input di log. Selezionare una delle opzioni dall'elenco Tipo di input, quindi immettere i valori pertinenti.
      • In Log eventi Windows, immettere un nome di input e selezionare uno o più canali evento.
      • Per Percorso log, immettere un nome di input e uno o più percorsi file. Ad esempio, /<log_path>/<log_name>.

      È possibile specificare più percorsi di file di log separati da una virgola (,). Per ulteriori informazioni, vedere https://docs.fluentd.org/input/tail#path.

      <source>
@type tail
tag 757261.oc_oslogs_linux
path /var/log/.log,/var/log/.out,/var/log/dmesg,var/log/grubby,/var/log/messages*,
 var/log/secure,/var/log/auth,/var/log/acpid,/root/.bash_history
pos_file /etc/unifiedmonitoringagent/pos/757261-oc_oslogs_linux.pos
path_key tailed_path
</source>
      Configurazione di esempio
      {{path C:\Program Files (x86)\<application>\<directory>*, 
 C:\Program Files (x86)\<application>\<application_logs_directory>\<directory>* }}

      Selezionare Aggiungi input log per aggiungere altri input di log personalizzati.

    16. Selezionare Mostra opzioni parser avanzate, quindi selezionare un parser per specificare come analizzare il log. Alcuni parser richiedono un ulteriore input e hanno più opzioni, a seconda del tipo scelto.

      Ad esempio, per JSON, è necessario selezionare un valore Tipo di tempo dalla lista, mentre, facoltativamente, è possibile specificare le impostazioni relative all'ora dell'evento e ai campi nulli. Per REGEXP, è possibile specificare l'espressione regolare per i log corrispondenti, insieme al formato dell'ora. Per ulteriori informazioni, vedere Log Inputs and Parsers.

      Importante

      Il tipo di parser NESSUNO è obbligatorio, anche se non si desidera specificare un particolare tipo di parser.
    17. Selezionare Crea.

      Viene creato l'oggetto log personalizzato, insieme alla relativa configurazione agente associata (se specificata), che estrae i dati dalle istanze ed esegue il push nell'oggetto log personalizzato.

  • Utilizzare il comando oci logging log create e i parametri richiesti per creare un log in un gruppo di log.

    oci logging log create --display-name display_name --log-group-id log_group_ocid --log-type log_type [OPTIONS]

    Per un elenco completo dei parametri e delle opzioni variabili per i comandi CLI, vedere Command Line Reference.

  • Eseguire l'operazione CreateLog per creare un log in un gruppo di log.