Risoluzione dei problemi relativi ai collegamenti

Utilizzare le informazioni di risoluzione dei problemi per identificare e risolvere i problemi comuni che possono verificarsi durante l'utilizzo dell'hub connettore.

Vedere anche Problemi noti per l'hub connettore.

Nessun dato da spostare

Risolvere i problemi relativi allo spostamento dei dati attraverso i connettori.

Il connettore non sta spostando i dati. Ad esempio, i connettori, vedere Scenari hub connettore.

Causa: i dati non esistono

L'origine non contiene dati corrispondenti alla query nella configurazione di origine del connettore.

Per determinare se esistono dati nell'origine, effettuare una delle operazioni riportate di seguito.

  • Ottenere i log del servizio per il connettore. Se necessario, abilitare prima i log. Di seguito è riportato un messaggio di log di esempio che indica un'esecuzione del connettore riuscita, inclusa la quantità di dati spostati.
    Service connector run succeeded - <number> messages (<number> bytes) written to target
  • Per i log di origine, cercare i log utilizzando la query dalla configurazione di origine del connettore.
  • Per le metriche di origine, eseguire una query sulle metriche.
  • Per i flussi di origine, eseguire una query sulle metriche predefinite del producer del flusso.

Rimedio: aggiornare il connettore

Modificare la configurazione per il servizio di origine per specificare i dati esistenti. Vedere Aggiornamento di un connettore.

Causa: errore a livello di servizio

Un errore nel servizio di origine, nel servizio di destinazione o nel servizio hub connettore impedisce lo spostamento dei dati.

Per determinare se esiste un errore a livello di servizio, effettuare una delle operazioni riportate di seguito.

  • Ottenere i log del servizio per il connettore. Se necessario, abilitare prima i log. Di seguito è riportato un messaggio di log di esempio che indica un errore a livello di servizio.
    Connector run failed due to <type> error, Error Code : XXX <exception>
  • Visualizzare i grafici delle metriche per il connettore riportati di seguito.
    • Errori nell'origine
    • Errori nella destinazione
    • Errori hub connettore

Rimedio: aggiornare il connettore

Modificare la configurazione per il servizio di origine o di destinazione. Vedere Aggiornamento di un connettore.

Rimedio: Contatta l'assistenza

Se in Errori dell'hub del connettore viene visualizzato 5xx o -1, contattare il supporto. Vedere Come ottenere assistenza e contattare il Supporto.

Causa: autorizzazione mancante

Non si dispone dell'autorizzazione per scrivere nel servizio di destinazione.

Per scoprire se manca l'autorizzazione, ottenere i log del servizio per il connettore. Se necessario, abilitare prima i log. Di seguito è riportato un messaggio di log di esempio che indica la mancanza di autorizzazione:

Connector run failed due to <type> error, Error Code : 404 NotAuthorizedOrNotFound

Rimedio: Ottieni autorizzazione

Assicurarsi di disporre dell'autorizzazione mediante il criterio predefinito offerto durante la creazione o l'aggiornamento del connettore o mediante un criterio basato su gruppi. Vedere Accesso ai servizi di origine, task e destinazione.
Nota

La propagazione dei criteri predefiniti accettati potrebbe richiedere alcuni minuti alle aree non appartenenti alla propria area di origine. Il connettore non sposta i dati finché i criteri non vengono propagati.

Disattivazione per motivi sconosciuti

Risolvere i problemi relativi a un connettore disattivato.

Lo stato di un connettore è Deactivated e non è stato disattivato.

Un altro utente ha disattivato il connettore

Il connettore è stato disattivato da un altro utente:

  • Un altro utente dell'organizzazione
  • Oracle Cloud Infrastructure

    Per determinate condizioni di errore, un connettore con errori continui viene disattivato automaticamente dal team del servizio su Oracle Cloud Infrastructure. Un errore continuo a lungo termine può indicare una configurazione non valida dell'origine o della destinazione del connettore.

Riattiva il connettore

  1. Aggiornare il connettore per garantire la configurazione valida dell'origine e della destinazione.
  2. (Facoltativo) Per ottenere dettagli sul flusso di dati dall'origine di un connettore alla relativa destinazione, abilitare i log per il connettore.
  3. Riattivare il connettore.
  4. Confermare che il connettore sposta correttamente i dati controllando i risultati previsti nel servizio di destinazione.

Annuncio: connettore disattivato

Un annuncio della console indica "Connettore disattivato".

Causa: per determinate condizioni di errore, un connettore con errori continui viene disattivato automaticamente dal team del servizio in Oracle Cloud Infrastructure. Un errore continuo a lungo termine può indicare una configurazione non valida dell'origine o della destinazione del connettore.

Riattiva il connettore

  1. Aggiornare il connettore per garantire la configurazione valida dell'origine e della destinazione.
  2. (Facoltativo) Per ottenere dettagli sul flusso di dati dall'origine di un connettore alla relativa destinazione, abilitare i log per il connettore.
  3. Riattivare il connettore.
  4. Confermare che il connettore sposta correttamente i dati controllando i risultati previsti nel servizio di destinazione.

Impossibile visualizzare la query in modalità base

Risolvere i problemi relativi alla visualizzazione della query in modalità Base nella console.

La console non consente la selezione della modalità Base dopo aver modificato la query in modalità Avanzata.

Causa: la query è troppo complessa

La query include uno o più dei seguenti elementi non supportati in modalità Base:

  • Operatore OR (ad eccezione dei filtri basati sul tipo quando si utilizzano solo i log di audit)
  • Funzioni (ad esempio: isNull())
  • select
  • summarize

Rimedio: aggiorna la query

Aggiornare la query in modo che includa solo gli elementi supportati in modalità Base:

  • Solo log di audit: i filtri basati sul tipo possono utilizzare l'operatore OR. Gli altri filtri devono utilizzare l'operatore AND.
    Ad esempio:
    ((type = value1 OR type = value2) AND field = value3 AND field1 = value4)
  • Qualsiasi combinazione di log (log del servizio, log personalizzati e log di audit): filtri uniti con l'operatore AND.
    Ad esempio:
    (field = value AND field1 != value1)

Come faccio a sapere quando si verificano problemi?

Identificare quando si verificano problemi con i connettori.

Cercare i seguenti indicatori di problemi con i connettori.

  • Aggiornamento dei dati per un singolo connettore: cercare intervalli di tempo imprevisti tra lo spostamento dei dati.
    1. Aprire il menu di navigazione e selezionare Analytics e AI. In Messaggistica, selezionare Hub connettore.
    2. Scegliere un compartimento.
    3. Selezionare il nome del connettore desiderato.
    4. In Risorse, selezionare Metriche.
    5. Rivedere il grafico delle metriche Aggiornatezza dei dati.
  • Aggiornamento dei dati tra i connettori: cerca intervalli di tempo imprevisti tra lo spostamento dei dati.
    1. Aprire il menu di navigazione e selezionare Osservabilità e gestione. In Monitoraggio, selezionare Metriche servizio.
    2. Scegliere il compartimento contenente i connettori per i quali si desidera visualizzare la freschezza dei dati.
    3. Per Spazio di nomi metrica, selezionare oci_service_connector_hub.

    4. Esaminare i grafici delle metriche riportati di seguito. 
      • Attualità dei dati
  • Origine di log: se il connettore recupera i dati da un log, potrebbe tentare di recuperare più della quantità massima di dati per connettore (1 GB). I dati di log nella destinazione non vengono consegnati se questo problema continua a verificarsi nelle ultime 24 ore (la durata massima per il recupero dei dati persi nelle trasmissioni precedenti da parte del connettore). Per determinare se si verifica questo problema, creare allarmi per monitorare gli indicatori riportati di seguito.

    Nota

    Per la procedura di modifica delle query di allarme in MQL, vedere Modifica dell'espressione MQL durante l'aggiornamento di un allarme.
    Indicatore (metrica) Query di allarme in MQL con commenti
    Dati più vecchi di 12 ore (Aggiornatezza dei dati)
    DataFreshness[1h].mean() > 43200000

    Commenti:

    • Il valore 43200000 è il numero di millisecondi in 12 ore.
    • Ignorare gli errori occasionali. Si consiglia di impostare il ritardo del trigger di allarme su 30 minuti o più. Con questa configurazione, l'allarme viene visualizzato solo quando si verificano più errori consecutivi nel periodo di tempo specificato.
    Errore all'origine (qualsiasi errore) (Errori all'origine)
    ErrorsAtSource[15m].groupby(errorCode,connectorId).min() > 0

    Commenti:

    • Ignorare gli errori occasionali. Si consiglia di impostare il ritardo del trigger di allarme su 30 minuti o più. Con questa configurazione, l'allarme viene visualizzato solo quando si verificano più errori consecutivi nel periodo di tempo specificato.
    • I risultati sono raggruppati per codice di errore e connettore.
    Errori interni all'origine che non vengono risolti dopo 15 minuti (5xx) (Errori all'origine)
    ErrorsAtSource[15m]{errorCode =~ "5*"}.groupby(connectorId).sum() > 0 && 
    ErrorsAtSource[15m].groupby(connectorId).min() > 0

    Commenti:

    • Gli errori interni potrebbero indicare un problema all'origine, che potrebbe ritardare la consegna dei dati.
    • Per attivare l'allarme a intervalli più brevi, modificare l'intervallo ([15m]).
    • Ignorare gli errori occasionali. Si consiglia di impostare il ritardo del trigger di allarme su 30 minuti o più. Con questa configurazione, l'allarme viene visualizzato solo quando si verificano più errori consecutivi nel periodo di tempo specificato.
    Limitazione degli errori nell'origine (429) (Errori nell'origine)
    ErrorsAtSource[15m]{errorCode = "429"}.groupby(connectorId).sum() >0 && 
    ErrorsAtSource[15m].groupby(connectorId).min() > 0

    Commenti:

    • Per ulteriori informazioni sugli errori di limitazione, vedere i limiti documentati per il servizio pertinente.
    • Ad esempio, per gli errori di limitazione correlati all'origine Streaming, vedere Limiti sulle risorse di streaming. La limitazione all'origine Streaming si verifica quando un connettore tenta di leggere un flusso da una partizione, si verificano anche altre chiamate alla stessa partizione e il numero di chiamate supera i limiti del servizio.
    • Ignorare gli errori occasionali. Si consiglia di impostare il ritardo del trigger di allarme su 30 minuti o più. Con questa configurazione, l'allarme viene visualizzato solo quando si verificano più errori consecutivi nel periodo di tempo specificato.
    Errore di comunicazione del servizio nell'origine (-1) (Errori nell'origine)
    ErrorsAtSource[15m]{errorCode = "-1"}.groupby(connectorId).sum() >0 && 
    ErrorsAtSource[15m].groupby(connectorId).min() > 0
    Errore 404 all'origine (Errori all'origine)
    ErrorsAtSource[15m]{errorCode = "404"}.groupby(connectorId).sum() >0

    Commenti:

    • Il connettore non può accedere al log o non esiste.
    • Assicurarsi che esistano criteri per accedere al log specificato. Vedere Accesso ai servizi di origine, task e destinazione.
    • Verificare che il log specificato esista cercandolo in Log.
    • Ignorare gli errori occasionali. Si consiglia di impostare il ritardo del trigger di allarme su 30 minuti o più. Con questa configurazione, l'allarme viene visualizzato solo quando si verificano più errori consecutivi nel periodo di tempo specificato.
    Zero (0) byte letti (quando i dati sono previsti) (byte letti dall'origine)
    BytesReadFromSource[15m].groupby(connectorId).sum() == 0

    Commenti:

    • Se gli errori non si verificano nell'origine, nella destinazione o nel task, è possibile che il log non esista. Verificare che il log specificato esista cercandolo in Log.
    • Ignorare gli errori occasionali. Si consiglia di impostare il ritardo del trigger di allarme su 30 minuti o più. Con questa configurazione, l'allarme viene visualizzato solo quando si verificano più errori consecutivi nel periodo di tempo specificato.