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 precedenti 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 Logging Analytics.

1. Accedere alla pagina Caricamenti da Oracle Logging Analytics:

   Aprire il menu di navigazione e fare clic su Osservabilità e gestione. In Logging Analytics, fare clic su Amministrazione. Viene visualizzata la pagina Panoramica dell'amministrazione.

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

2. Nella pagina Caricamenti fare clic su Carica file.
   Viene visualizzata la pagina Carica file.
3. Selezionare i file:
   • Immettere il Nome caricamento. Questo è il nome utilizzato per 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 il compartimento gruppo di log per definire l'ambito in cui si trova il gruppo di log.
   • Selezionare il gruppo di log in cui memorizzare 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 la descrizione. Fare clic su Crea.

   • Fare clic sul pulsante Seleziona file e selezionare i file di log da caricare. I tipi di file quali zip, tar, tgz e gli eventuali file di testo di tipo RAW 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 è di 100 MB. È possibile caricare al massimo 25 singoli file per ogni caricamento. Un file senza contenuto non è valido e non viene considerato per il caricamento quando sono selezionati più file.

   Successivo.

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 > 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. 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. Se si desidera, è possibile specificare l'entità. In base al compartimento entità selezionato e al tipo di entità definito nell'origine selezionata, viene popolato il menu a discesa Entità. 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 Log Timezone, Character Encoding, Date Format e Log Content Year. Fare clic su Salva modifiche.
      • Log Timezone: informazioni sul fuso orario da utilizzare per l'elaborazione delle voci di log. Per impostazione predefinita, per l'elaborazione vengono utilizzate le informazioni sul fuso orario nella voce di log. Quando le informazioni non sono disponibili nella voce di log, viene considerato il valore selezionato dal menu. Se il valore non è disponibile in questo menu o direttamente dalla voce di log, viene considerato il fuso orario dell'entità. Se nel fuso orario non sono disponibili informazioni, il valore predefinito considerato è UTC.
      • Codifica caratteri: la codifica dei caratteri dei file di log da caricare. Oracle Logging Analytics tenta di rilevare automaticamente la codifica dei caratteri, ma in casi d'uso specifici potrebbe essere necessario sostituire 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 eventuali ambiguità nell'identificazione del formato della data nella voce di log specificata. Ad esempio, se la data è 12/10 e può essere interpretata come 12th October o 10th December, è possibile utilizzare DAY_MONTH o MONTH_DAY per rimuovere l'ambiguità. Nel caso in cui la data sia 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à, quindi è possibile ignorare la specifica del formato data.

      • Anno contenuto log: informazioni sull'anno da utilizzare per l'elaborazione delle voci di log quando le voci di log non dispongono delle 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.

      Prima di procedere al caricamento, assicurarsi di selezionare un'origine per ogni file di caricamento.

   5. Successivo.
5. Rivedi: rivedere le proprietà dei file selezionati per il caricamento. Per confermare le proprietà e avviare il caricamento, fare clic su Caricamento.

   Oracle Logging Analytics indicizza ed elabora i file. Al termine del caricamento, fare clic su Chiudi per andare alla pagina dell'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 passare alla pagina dell'elenco dei caricamenti.

È possibile utilizzare l'interfaccia CLI OCI per caricare i file di log in Oracle Logging Analytics tramite un'interfaccia della riga di comando. Questa semplice interfaccia ti consente di automatizzare i caricamenti integrando l'interfaccia CLI nella tua applicazione.

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

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

Eseguire i comandi CLI riportati di seguito per gestire loganalytics-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>

  Esempio di risposta 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 elenchi:

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

• Recupera caricamento:

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

• File caricamento elenco:

  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 Osservabilità e gestione. In Logging Analytics, fare clic su Amministrazione. Viene visualizzata la pagina Panoramica dell'amministrazione.
2. Nel pannello sinistro, in Risorse, fare clic su Caricamenti. Vengono visualizzati gli ultimi caricamenti su richiesta.
3. Per visualizzare i dati elaborati del caricamento, fare clic sull'icona di menu corrispondente al caricamento > 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 si nota che il caricamento del file non è riuscito o non si desidera più conservare i file per questo caricamento, è possibile eliminarli.

1. Aprire il menu di navigazione e fare clic su Osservabilità e gestione. In Logging Analytics, fare clic su Amministrazione. Viene visualizzata la pagina Panoramica dell'amministrazione.
2. Nel pannello sinistro, in Risorse, fare clic su Caricamenti. Vengono visualizzati gli ultimi caricamenti su richiesta.
3. Per eliminare un caricamento su richiesta, fare clic sull'icona di menu corrispondente al caricamento > 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.

   Viene visualizzata 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 di metadati e denominarlo uploads_metadata.json. Di seguito è riportato un file di metadati di esempio.

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

Nel file precedente field1 e field2 sono campi definiti da Oracle o definiti dall'utente. Vedere Creare 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 in un file uploads_metadata.json. Il file uploads_metadata.json deve trovarsi nella parte superiore della gerarchia del file zip.