Documentazione dell'infrastruttura Oracle Cloud

Risolvere i problemi relativi alla pipeline di inclusione

Dopo l'inclusione dei dati di log in Log Analytics mediante uno qualsiasi dei metodi di inclusione disponibili, l'elaborazione dei dati inizia in modo asincrono. Durante l'elaborazione dei dati, se si verificano errori relativi alla configurazione, alla dimensione o alla struttura del log, all'autorizzazione (applicabile solo per il tipo ObjectCollection) o alla definizione del parser, possono verificarsi problemi quali:

  • Dati di log non disponibili in Log Explorer per la visualizzazione

  • Solo dati parziali disponibili per la visualizzazione

  • I dati vengono elaborati in modo incompleto e contrassegnati con errori di analisi

  • I dati non sono associati a risorse previste come entità o metadati aggiuntivi

Utilizzare la metrica Errori di elaborazione per rilevare l'errore e risolvere i problemi della pipeline di inclusione identificando il tipo di errore e mappandolo al metodo di inclusione utilizzato. Per i passi per accedere alla metrica Errori di elaborazione, vedere Monitorare Log Analytics mediante le metriche dei servizi.

Di seguito sono riportati i metodi di inclusione (collectionType) per i quali verrà generata la metrica degli errori di elaborazione.

  • Caricamento su richiesta (ODU): per tutti i dati caricati in Log Analytics tramite uno dei metodi di caricamento su richiesta.

  • Inserisci utilizzando il connettore servizio (ServiceConnector): utilizzare il connettore servizio per raccogliere i log dal servizio Oracle Cloud Infrastructure con Log Analytics come destinazione.

  • Raccogli dati dal bucket di storage degli oggetti (ObjectCollection): per i dati di log raccolti in modo continuo che sono stati memorizzati in un bucket dell'area di memorizzazione degli oggetti Oracle Cloud.

  • Raccolta Log Events (LogEventsCollection): per i dati raccolti mediante l'interfaccia API uploadLogEvents.

Quando vengono rilevati errori, la metrica Errori di elaborazione visualizza una riga per ogni tipo di raccolta abilitato nella tenancy o nel compartimento. Passare il cursore sui datapoint nel grafico per visualizzare ulteriori dettagli sull'errore. Seguire questi passaggi quando viene segnalato un errore per un tipo di raccolta e si desidera trovare il tipo di errore esatto:

  1. Fare clic sul menu Opzioni nell'angolo superiore destro della metrica Errori di elaborazione e selezionare Visualizza in Explorer metriche.

    La metrica viene ora visualizzata in Esplora metriche. Qui è possibile visualizzare il grafico in modo più dettagliato.

  2. Fare clic su Modifica query e selezionare Nome dimensione e Valore dimensione per la metrica. Ad esempio, se la metrica Errore di elaborazione ha segnalato un errore per il tipo di raccolta ServiceConnector, selezionare il valore del nome della dimensione come collectionType e il valore della dimensione come serviceConnector.

    Fare clic su Aggiorna grafico per aggiornare la visualizzazione del grafico. Il grafico ora visualizzerà solo gli errori del flusso di raccolta dei log delle connessioni al servizio. Rappresenta una riga per ogni combinazione di errorType e resourceId.

    È possibile passare alla vista Tabella dati per una rappresentazione in formato tabulare dei datapoint di errore raccolti.

  3. Modificare il nome della dimensione in errorType e resourceId e visualizzare le informazioni di errore corrispondenti nel grafico.

Di seguito sono riportati i vari tipi di errori segnalati tramite questa metrica.

Tipo di errore descrizione; Correzione consigliata

InvalidConfiguration

Si è verificato un errore nella configurazione fornita, ad esempio un'origine log errata o dettagli entità errati.

Ad esempio:

  • Connettore servizio: eventType non è riconosciuto o supportato in Log Analytics; è possibile che sia stato configurato un mapping errato di eventType se si utilizzano log personalizzati.
  • Caricamento su richiesta (ODU), Raccolta oggetti: è possibile che l'origine utilizzata durante l'esecuzione di un'unità ODU non sia valida; il tipo di origine non è supportato da ODU; la combinazione di origine e tipo di entità (se specificata EntityId) non è valida.

Rivedere le impostazioni di configurazione e verificare che siano impostate correttamente. Vedere Gerarchia delle risorse chiave.

InvalidPayload

I dati inclusi presentano uno dei problemi riportati di seguito.

  • Formato payload non valido
  • Supera il limite di dimensione
  • Formato di archivio non valido

Verificare che i dati siano conformi al limite delle dimensioni, al formato e ai formati di archivio prescritti. Vedere Log di input.

StructureMismatch

Mancata corrispondenza tra i dati identificati per la raccolta e la definizione del parser.

Ad esempio:

  • L'espressione iniziale della voce non ha una corrispondenza nel file JSON o XML specificato, con conseguente raccolta di voci di log ZERO
  • Quando l'origine ha un tipo di parser Regex, ma è disponibile un file JSON per la raccolta

Verificare la definizione del parser e assicurarsi che i dati in entrata siano conformi alla definizione fornita. Creare un parser

NotAuthorizedOrNotFound

Questo errore è visibile solo per la raccolta dei dati dal bucket di storage degli oggetti quando viene rilevato un errore di autorizzazione durante la lettura dei dati dalla tenancy.

Ad esempio:

  • I criteri richiesti per Log Analytics per leggere gli oggetti dalla tenancy sono stati rimossi o non esistono.

Controllare i criteri IAM creati per abilitare la raccolta di log dal bucket di storage degli oggetti e verificare che a Log Analytics vengano concesse le autorizzazioni riportate di seguito.

allow service loganalytics to read buckets in compartment/tenancy

allow service loganalytics to read objects in compartment/tenancy