Caricare i log su richiesta

Argomenti:

• Consenti agli utenti di eseguire operazioni di creazione, recupero ed elenco caricamento su richiesta
• Consenti agli utenti di eseguire l'operazione di eliminazione del caricamento su richiesta

allow group <group_name> to {LOG_ANALYTICS_LOG_GROUP_UPLOAD_LOGS} in compartment <log_group_compartment>
allow group <group_name> to {LOG_ANALYTICS_ENTITY_UPLOAD_LOGS} in compartment <entity_compartment>
allow group <group_name> to {LOG_ANALYTICS_SOURCE_READ} in tenancy
allow group <group_name> to use loganalytics-ondemand-upload in tenancy

allow group <group_name> to use loganalytics-ondemand-upload in tenancy
allow group <group_name> to use loganalytics-log-group in compartment <log_group_compartment>
allow group <group_name> to read loganalytics-source in tenancy
allow group <group_name> to {LOG_ANALYTICS_ENTITY_UPLOAD_LOGS} in compartment <entity_compartment>

allow group <group_name> to use loganalytics-features-family in tenancy
allow group <group_name> to use loganalytics-resources-family in tenancy/compartment

allow group <group_name> to use loganalytics-ondemand-upload in tenancy
allow group <group_name> to {LOG_ANALYTICS_LOG_GROUP_DELETE_LOGS} in compartment <log_group_compartment>
allow group <group_name> to {LOG_ANALYTICS_QUERY_VIEW} in tenancy
allow group <group_name> to {COMPARTMENT_QUERY} in tenancy

allow group <group_name> to use loganalytics-ondemand-upload in tenancy
allow group <group_name> to manage loganalytics-log-group in compartment <log_group_compartment>
allow group <group_name> to read loganalytics-query in tenancy
allow group <group_name> to read compartments in tenancy

allow group <group_name> to use loganalytics-features-family in tenancy
allow group <group_name> to manage loganalytics-resources-family in tenancy/compartment
allow group <group_name> to read compartments in tenancy

group_name in tutte le istruzioni dei criteri sopra riportate fa riferimento al gruppo di utenti a cui devono essere assegnate le autorizzazioni necessarie.

È possibile caricare i file di log utilizzando la procedura guidata Caricamento su richiesta (ODU) disponibile nella console del servizio di Oracle Log Analytics.

1. Accedere alla pagina Caricamenti da Oracle Log Analytics:

   Aprire il menu di navigazione e fare clic su Observability & Management. In Log Analytics, fare clic su Amministrazione.

   Le risorse di amministrazione sono elencate nel riquadro di navigazione a sinistra in Amministrazione. Fare clic su Carica.

2. Nella pagina Carichi fare clic su Carica file.
   Viene visualizzata la pagina Carica file.
3. Selezionare i file:
   • Immettere il Nome caricamento. Nome che consente di tenere traccia dello stato dei file di log caricati. È possibile eseguire più caricamenti in momenti diversi utilizzando lo stesso nome di caricamento se si desidera mantenere insieme un set di caricamenti.
   • Selezionare Compartimento gruppo di log per definire l'ambito in cui si trova il gruppo di log.
   • Selezionare il gruppo di log in cui devono essere memorizzati i log.

     Per creare un nuovo gruppo di log, selezionare il compartimento e fare clic su Crea gruppo di log. nella finestra di dialogo immettere il nome e una descrizione. Fare clic su Crea.

   • Fare clic sul pulsante Seleziona file e selezionare i file di log da caricare. I tipi di file, ad esempio zip, tar, tgz e qualsiasi file di testo non elaborati, vengono accettati per il caricamento. È possibile selezionare più file in un singolo caricamento.

   Viene visualizzato un riepilogo dei file selezionati per il caricamento. Si noti che la dimensione massima del singolo file è 100 MB. È possibile caricare un massimo di 25 singoli file per caricamento. Un file senza contenuto non è valido e non viene considerato per il caricamento quando sono selezionati più file.

   Fare clic su Avanti.

4. Imposta proprietà: nella pagina viene visualizzata la lista dei file selezionati nel primo passo. È obbligatorio specificare l'origine da utilizzare per l'elaborazione di ogni file. Facoltativamente, è possibile fornire altre proprietà aggiuntive. Per impostare le proprietà di tutti i file, selezionare la casella di controllo nell'intestazione e fare clic su Imposta proprietà. Per impostare le proprietà di un file specifico, fare clic sull'icona del menu Azioni accanto al nome del file e fare clic su Imposta proprietà. Viene visualizzata la finestra di dialogo Imposta proprietà.
   1. Selezionare l'origine da utilizzare per elaborare i file di log dal menu a discesa Origine.

      Per eseguire il caricamento su richiesta, l'origine deve essere di tipo System Event Messages (Syslog), File o Oracle Diagnostic Logs (ODL).

   2. Facoltativamente, se si desidera mappare questi file caricati a un'entità, selezionare il compartimento in cui si trova l'entità dal menu a discesa Compartimento entità.
   3. Facoltativamente, è possibile specificare l'entità. In base al compartimento entità selezionato e al tipo di entità definito nell'origine selezionata, il menu a discesa Entità viene popolato. Selezionare l'entità.
   4. Facoltativamente, potrebbe essere necessario specificare le proprietà avanzate quando le informazioni richieste non sono disponibili nella voce di log per l'elaborazione corretta. Espandere la sezione Mostra opzioni avanzate. Nel menu a discesa, selezionare i valori dei parametri Fuso orario log, Codifica caratteri, Formato data e Anno contenuto log. Fare clic su Salva modifiche.
      • Log Timezone: le informazioni sul fuso orario da utilizzare per l'elaborazione delle voci di log. Per impostazione predefinita, le informazioni sul fuso orario nella voce di log vengono utilizzate per l'elaborazione. Se le informazioni non sono disponibili nella voce di log, viene considerato il valore selezionato dal menu. Se il valore non è disponibile da questo menu o direttamente dalla voce di log, viene considerato il fuso orario dell'entità. Se non sono disponibili informazioni sul fuso orario, il valore predefinito considerato è UTC.
      • Codifica caratteri: la codifica dei caratteri dei file di log da caricare. Oracle Log Analytics tenta di rilevare automaticamente la codifica dei caratteri, ma in casi d'uso specifici potrebbe essere necessario eseguire l'override di questo valore.
      • Formato data: il formato per le informazioni sulla data disponibili nei file di log. Quando si utilizza la macro {TIMEDATE}, utilizzare questo parametro per rimuovere qualsiasi ambiguità nell'identificazione del formato della data nella voce di log specificata. Ad esempio, se la data è 12/10, dove può essere interpretata come 12th October o 10th December, è possibile utilizzare DAY_MONTH o MONTH_DAY per rimuovere l'ambiguità. Se la data è 12/10/08, è possibile utilizzare DAY_MONTH_YEAR, MONTH_DAY_YEAR o YEAR_MONTH_DAY.

        Se il parser utilizza l'estrazione del componente orario, non vi sono ambiguità e pertanto è possibile saltare la specifica del formato data.

      • Anno contenuto log: le informazioni sull'anno da utilizzare per elaborare le voci di log quando le voci di log non contengono le informazioni sull'anno nell'indicatore orario.

      Espandere la riga nella tabella per visualizzare le proprietà specificate. Se necessario, è possibile rimuovere i file selezionati dall'elenco di caricamento.

      Assicurarsi di selezionare un'origine per ogni file di caricamento prima di continuare il caricamento.

   5. Fare clic su Avanti.
5. Revisione: rivedere le proprietà dei file selezionati per il caricamento. Per confermare le proprietà e avviare il caricamento, fare clic su Carica.

   Oracle Log Analytics indicizza ed elabora i file. Al termine del caricamento, fare clic su Chiudi per andare alla pagina di elenco dei caricamenti.

   Se il caricamento di un file non riesce, fare clic sull'icona Riprova accanto al nome del file per caricare di nuovo il file. Una volta completato il caricamento, fare clic su Chiudi per andare alla pagina di elenco dei caricamenti.

È possibile utilizzare l'interfaccia CLI OCI per caricare i file di log in Oracle Log Analytics tramite un'interfaccia a riga di comando. Questa semplice interfaccia consente di automatizzare i caricamenti integrando l'interfaccia CLI nell'applicazione.

Per informazioni sull'uso dell'interfaccia CLI, vedere Command Line Interface (CLI).

Per un elenco completo dei flag e delle opzioni disponibili per i comandi CLI, vedere Riferimento riga di comando: Log Analytics - Caricamento.

Eseguire i comandi CLI riportati di seguito per gestire il caricamento-ondemand-upload.

• File di log del caricamento:

  oci log-analytics upload upload-log-file --namespace-name <namespace_name> --log-source-name <log-source-name> --upload-name <upload-name> --filename <file_name> --opc-meta-loggrpid <opc-meta-loggrpid> --file <path_to_log_file>

  Risposta di esempio del comando precedente:

  {
    "data": {
    "name": null,   
    “reference” : “32817130200562135",
    “timeCreated” : “2020-06-01T12:00:00.000Z”,
    "time-earliest-log-entry": null,
    "time-latest-log-entry": null,
    "time-updated": null,
    "warnings-count": null
    }
  }

• Elimina caricamento:

  oci log-analytics upload delete --namespace-name <namespace_name> --upload-reference <upload-reference>

• Caricamenti elenco:

  oci log-analytics upload list --namespace-name <namespace_name>

• Recupera caricamento:

  oci log-analytics upload get --namespace-name <namespace_name> --upload-reference <upload-reference>

• Elenca file di caricamento:

  oci log-analytics upload list-upload-files --namespace-name <namespace_name> --upload-reference <upload-reference>

• Elimina caricamento file:

  oci log-analytics upload delete-upload-file --namespace-name <namespace_name> --upload-reference <upload-reference> --file-reference <file-reference>

Dopo aver completato un caricamento su richiesta dei dati di log, è possibile visualizzare il riepilogo dei caricamenti e verificare lo stato del file.

1. Aprire il menu di navigazione e fare clic su Observability & Management. In Log Analytics, fare clic su Amministrazione.
2. Le risorse di amministrazione sono elencate nel riquadro di navigazione a sinistra in Amministrazione. Fare clic su Carica. Visualizza gli ultimi caricamenti su richiesta.
3. Per visualizzare i dati elaborati del caricamento, fare clic sull'icona di menu corrispondente al caricamento e selezionare Visualizza in Log Explorer.
4. Per visualizzare la lista dei file nel caricamento insieme al relativo stato di elaborazione, fare clic sul nome del caricamento.

Dopo aver completato un caricamento su richiesta dei dati di log, è possibile visualizzare il riepilogo dei caricamenti e verificare lo stato del file. Se, nel caso in cui si noti che il caricamento del file non è riuscito o non si desidera più mantenere i file per questo caricamento, è possibile eliminarli.

1. Aprire il menu di navigazione e fare clic su Observability & Management. In Log Analytics, fare clic su Amministrazione.
2. Le risorse di amministrazione sono elencate nel riquadro di navigazione a sinistra in Amministrazione. Fare clic su Carica. Visualizza gli ultimi caricamenti su richiesta.
3. Per eliminare un caricamento su richiesta, fare clic sull'icona di menu corrispondente al caricamento e selezionare Elimina.
4. Per eliminare un file in un caricamento su richiesta, fare clic sul nome del caricamento per andare alla pagina dei dettagli del caricamento.

   Visualizza la lista dei file inclusi nel caricamento specificato. È possibile visualizzare lo stato di ogni file adiacente al nome del file.

   Per eliminare un file, fare clic sull'icona di menu accanto al nome del file e selezionare Elimina.

Creare un file json dei metadati e assegnargli un nome uploads_metadata.json. Di seguito è riportato un esempio di file di metadati:

{
    "field1":"value1",
    "field2":"value2"
}

Nel file precedente field1 e field2 sono campi definiti da Oracle o definiti dall'utente. Vedere Crea un campo. Tutti questi campi insieme ai valori forniti verranno aggiunti a ogni record di log analizzato.

Creare un file di archivio zip contenente i dati di log effettivi in uno dei formati di file supportati e il file uploads_metadata.json. Il file uploads_metadata.json deve trovarsi nella gerarchia superiore del file zip.