Oracle Cloud Infrastructure-Dokumentation

Fehler in Aufnahmepipeline beheben

Nachdem die Logdaten mit einer der verfügbaren Aufnahmemethoden in Logging Analytics aufgenommen wurden, beginnt die Datenverarbeitung asynchron. Wenn bei der Datenverarbeitung Fehler im Zusammenhang mit Konfiguration, Loggröße oder -struktur, Autorisierung (nur beim Typ ObjectCollection) oder Parserdefinition auftreten, kann das zu folgenden Problemen führen:

  • Die Logdaten sind nicht im Log Explorer zur Visualisierung verfügbar.

  • Nur ein Teil der Daten ist zur Visualisierung verfügbar.

  • Die Daten werden unvollständig verarbeitet und mit Parsefehlern getaggt.

  • Die Daten werden nicht mit erwarteten Ressourcen wie Entitys oder zusätzlichen Metadaten verknüpft.

Verwenden Sie die Metrik Verarbeitungsfehler, um den Fehler zu ermitteln und die Aufnahmepipeline zu beheben, indem Sie den Fehlertyp identifizieren und der verwendeten Aufnahmemethode zuordnen. Die Schritte für den Zugriff auf die Metrik "Verarbeitungsfehler" finden Sie unter Logging Analytics mit Servicemetriken überwachen.

Im Folgenden werden die Aufnahmemethoden (collectionType) aufgeführt, für die die Metrik "Verarbeitungsfehler" generiert wird:

  • On-Demand-Upload (ODU): Für alle Daten, die über eine der On-Demand-Uploadmethoden in Logging Analytics hochgeladen werden.

  • Mit Service-Connector aufnehmen (ServiceConnector): Verwenden Sie den Service-Connector, um die Logs aus dem Oracle Cloud Infrastructure-Service mit Logging Analytics als Ziel zu erfassen.

  • Daten aus Objektspeicher-Bucket erfassen (ObjectCollection): Für kontinuierlich erfasste Logdaten, die Sie in einem Oracle Cloud-Objektspeicher-Bucket gespeichert haben.

  • Erfassung von Logereignissen (LogEventsCollection): Für die mit der API uploadLogEvents erfassten Daten.

Wenn Fehler ermittelt werden, zeigt die Metrik "Verarbeitungsfehler" eine Zeile für jeden im Mandanten oder Compartment aktivierten Erfassungstyp an. Bewegen Sie den Cursor auf die Datenpunkte im Diagramm, um weitere Details zum Fehler anzuzeigen. Gehen Sie wie folgt vor, wenn ein Fehler für einen Erfassungstyp gemeldet wird und Sie den genauen Fehlertyp ermitteln möchten:

  1. Klicken Sie oben rechts in der Metrik "Verarbeitungsfehler" auf das Menü Optionen, und wählen Sie In Metrik-Explorer anzeigen aus.

    Die Metrik wird jetzt im Metrik-Explorer angezeigt. Hier können Sie das Diagramm genauer untersuchen.

  2. Klicken Sie auf Abfragen bearbeiten, und wählen Sie Dimensionsname und Dimensionswert für die Metrik aus. Beispiel: Wenn die Metrik "Verarbeitungsfehler" einen Fehler für den Erfassungstyp ServiceConnector gemeldet hat, wählen Sie als Dimensionsname den Wert collectionType und als Dimensionswert serviceConnector aus.

    Klicken Sie auf Diagramm aktualisieren, um die Diagrammvisualisierung zu aktualisieren. Im Diagramm werden jetzt nur die Fehler aus dem Erfassungsablauf des Serviceverbindungslogs angezeigt. Es zeigt eine Zeile für jede Kombination aus errorType und resourceId an.

    Sie können zur Ansicht Datentabelle wechseln, um eine tabellarische Darstellung der erfassten Fehlerdatenpunkte anzuzeigen.

  3. Ändern Sie den Dimensionsnamen in errorType und resourceId, und zeigen Sie die entsprechenden Fehlerinformationen im Diagramm an.

Im Folgenden werden die verschiedenen Typen von Fehlern aufgeführt, die über diese Metrik gemeldet werden:

Fehlertyp Beschreibung Empfohlener Fix

InvalidConfiguration

Es ist ein Fehler mit der angegebenen Konfiguration aufgetreten, z.B. eine falsche Logquelle oder falsche Entitydetails.

Beispiele::

  • Service-Connector: eventType wird in Logging Analytics nicht erkannt oder unterstützt. Sie haben möglicherweise eine falsche Zuordnung von eventType konfiguriert, wenn Sie benutzerdefinierte Logs verwenden.
  • On-Demand-Upload (ODU), Objekterfassung: Die Quelle, die bei der Ausführung eines ODU verwendet wird, ist möglicherweise ungültig. Der Quellentyp wird von ODU nicht unterstützt. Die Kombination aus Quelle und Entitätstyp (wenn EntityId angegeben ist) ist ungültig.

Prüfen Sie die Konfigurationseinstellungen erneut, und stellen Sie sicher, dass sie korrekt festgelegt sind. Siehe Hierarchie von wichtigen Ressourcen.

InvalidPayload

Die aufgenommenen Daten weisen eines der folgenden Probleme auf:

  • Das Format der Payload ist ungültig.
  • Der Grenzwert für die Größe wurde überschritten.
  • Das Archivierungsformat ist ungültig.

Stellen Sie sicher, dass die Daten dem Größengrenzwert, dem Format und den vorgeschriebenen Archivierungsformaten entsprechen. Siehe Logs aufnehmen.

StructureMismatch

Die für die Erfassung identifizierten Daten stimmen nicht mit der Parserdefinition überein.

Beispiel:

  • Der Eintragsstartausdruck hat keine Übereinstimmung in der angegebenen JSON- oder XML-Datei, sodass keine Logeinträge erfasst werden.
  • Die Quelle weist den Parser-Typ "Regulärer Ausdruck" auf, aber es ist eine JSON-Datei zur Erfassung verfügbar.

Prüfen Sie die Parserdefinition, und stellen Sie sicher, dass die eingehenden Daten der angegebenen Definition entsprechen. Parser erstellen

NotAuthorizedOrNotFound

Dieser Fehler wird nur bei der Datenerfassung aus dem Objektspeicher-Bucket angezeigt, wenn beim Lesen der Daten aus dem Mandanten ein Autorisierungsfehler aufgetreten ist.

Beispiel:

  • Die erforderlichen Policys für das Lesen von Objekten aus dem Mandanten durch Logging Analytics wurden entfernt oder sind nicht vorhanden.

Prüfen Sie die IAM-Policys, die Sie für die Aktivierung der Logerfassung aus dem Objektspeicher-Bucket erstellt haben, und stellen Sie sicher, dass Logging Analytics die folgenden Berechtigungen erhalten hat:

allow service loganalytics to read buckets in compartment/tenancy

allow service loganalytics to read objects in compartment/tenancy