Runtime-Seite im Jitterbit Management Console

Übersicht

Einführung

Die Runtime-Seite ist eine Tabelle von Betriebsprotokollen. Wenn eine Operation ausgeführt wird, wird ein Betriebsprotokoll erstellt. Ein Betriebsprotokoll enthält Informationen darüber, wann und wo eine Operation ausgeführt wurde, den Status der Operation, die Anzahl der verarbeiteten Quell- und Zielaufzeichnungen sowie alle Protokollnachrichten. Ob detaillierte Protokollnachrichten angezeigt werden, hängt von Berechtigungen und Zugriffslevels sowie davon ab, ob das Cloud-Logging aktiviert ist.

Die Werkzeuge und Bereiche der Seite werden im gesamten Dokument erwähnt. Sie sind im Bild unten identifiziert:

Operationen-Details-Tabelle

Die verfügbaren Spalten sind wie folgt:

• Name: Der Name der API oder Operation, die mit dem Protokolleintrag verbunden ist. Für Betriebseinträge mit Kindern klicken Sie auf das Erweitern Symbol, um die gesamte Kette anzuzeigen. Klicken Sie auf das Minimieren Symbol, um eine Operation und ihre Kinder zu reduzieren. (Gilt für alle Protokolltypen.)

• Protokolltyp: Der Typ des Protokolleintrags: Benutzerdefinierte API, Proxy-API oder OData-API für Operationen, die durch einen API-Aufruf ausgelöst werden, oder Operation für direkt ausgeführte Operationen. (Gilt für alle Protokolltypen.)

• Umgebung: Der Name der Umgebung, in der die Operation bereitgestellt wurde. (Gilt für alle Protokolltypen.)

• Status: Der Status des Protokolleintrags. Für Benutzerdefinierte API, Proxy-API und OData-API Protokolleinträge ist dies der HTTP-Statuscode (siehe w3.org Statuscode-Definitionen). Für Operation Protokolleinträge ist dies einer der folgenden:

  • Eingereicht: Eine Operation wurde in die Harmony-Warteschlange eingereicht, wurde jedoch noch nicht von einem Agenten zur Ausführung akzeptiert.
  • Erhalten: Ein Agent bestätigt den Erhalt der Anfrage zur Ausführung einer Operation.
  • Ausstehend: Eine Operation ist in der Warteschlange zur Ausführung auf einem Agenten.
  • Ausführend: Ein Agent führt die Operation aus.
  • Stornierungsanfrage: Eine Anfrage zur Stornierung der Operation wurde gestellt. Operationen können diesen Status anzeigen und dennoch nach der Stornierung weiterlaufen.
  • Abgebrochen: Die Operation wurde abgebrochen.
  • Erfolgreich: Die Operation wurde erfolgreich abgeschlossen.
  • Erfolgreich mit Informationen: Die Operation wurde erfolgreich mit nicht fatalen Problemen abgeschlossen.

  • Erfolgreich mit Warnung: Die Operation wurde erfolgreich mit Warnungen abgeschlossen, wie in den Protokollnachrichten angezeigt.

    Hinweis

    Eine extra subelement-Warnung in den Protokollnachrichten kann im Allgemeinen ignoriert werden. Diese Warnung zeigt an, dass die API-Nutzlast eines Connectors mehr Knoten oder Felder von Daten zurückgegeben hat, als im Antwortdatenschema definiert sind.

  • Erfolg mit Kindfehler: Der Vorgang wurde erfolgreich abgeschlossen, aber eine oder mehrere untergeordnete Operationen hatten fatale Fehler. (Gilt für synchrone Operationen.)

  • Fehler: Der Vorgang ist fehlgeschlagen.
  • SOAP-Fehler: Der Vorgang ist mit einem SOAP-Fehler fehlgeschlagen. (Gilt für Operationen mit Studio SOAP oder Salesforce Endpunkten, oder Design Studio Webdiensten oder Salesforce Endpunkten.)

  Wenn für einen Vorgang Operation-Debug-Protokollierung auf Vorgangsebene aktiviert ist und der Vorgang auf einem Agenten der Version 10.48 oder höher ausgeführt wurde, zeigt die Status-Spalte im Debug-Protokoll-Tab den Status des Vorgangsschrittes an:

  • Abgeschlossen: Der Vorgangsschritt wurde ausgeführt und ohne Fehler abgeschlossen.
  • Fehler: Der Vorgangsschritt wurde ausgeführt, konnte jedoch aufgrund eines Fehlers nicht abgeschlossen werden.
  • Unvollständig: Der Vorgangsschritt wurde nicht ausgeführt oder abgeschlossen. Mögliche Gründe für diesen Status sind, dass der Vorgangsschritt auf die Ausführung wartet oder dass ein Fehler in einem vorherigen Vorgangsschritt die Ausführung des folgenden Schrittes verhindert hat.

• Gestart: Die Zeit, zu der der Vorgang angefordert wurde. (Gilt für alle Protokolltypen.)

• Beendet: Die Zeit, zu der sich der Status des Vorgangs zuletzt geändert hat. (Gilt für alle Protokolltypen.)

• Dauer: Die Zeit, die zwischen Begonnen und Beendet vergangen ist. (Gilt für alle Protokolltypen.)

• ID: Der eindeutige Identifikator für den Protokolleintrag. (Gilt für alle Protokolltypen.)

• API-Dienst-URL: Die vollständige URL zum Aufrufen der API, einschließlich der Basis-URL, des Dienststamms, der Version und aller Pfadparameter. Diese Spalte wird nur für Benutzerdefinierte API, Proxy-API und OData-API Protokolleinträge ausgefüllt.

• Agent: Der Agent Name. Diese Spalte wird nur für Betriebs Protokolleinträge ausgefüllt.

• Projekt: Der Name des Projekts, in dem der Betrieb läuft. Diese Spalte wird nur für Betriebs Protokolleinträge ausgefüllt.

• Root Operation Instance GUID: Der global eindeutige Identifikator (GUID) der Wurzel (obersten) Operation des Betriebs. Dieses Feld ist für Wurzeloperationen leer, und die Spalte ist standardmäßig ausgeblendet. Diese Spalte wird nur für Betriebs Protokolleinträge ausgefüllt. Um den Wert zu kopieren, fahren Sie mit der Maus darüber und klicken Sie dann auf Inhalt kopieren.

• Operation ID: Der global eindeutige Identifikator (GUID) der Operation. Diese Spalte wird nur für Betriebs Protokolleinträge ausgefüllt. (Diese Spalte ist standardmäßig ausgeblendet.)

• Aktionen: Fahren Sie mit der Maus über eine Operation, um verfügbare Aktionen anzuzeigen. Aktionen unterscheiden sich je nach Protokolltyp:

  Für Benutzerdefinierte API, Proxy-API und OData-API Protokolleinträge:

  • Anzeigen: Öffnen Sie die Protokolldetails.
  • API öffnen: Öffnen Sie die API im API-Manager.

  Für Betriebs Protokolleinträge:

  • Anzeigen: Öffnen Sie die Protokolldetails.

  • Betrieb abbrechen: Aktiviert für Operationen, die den Status Eingereicht, Empfangen, Ausstehend oder Läuft haben. Betrieb abbrechen sendet eine Anfrage an den Agenten, um den Betrieb zu stoppen. Nach dem Klicken wird der Status Abbrechen angefordert neben dem Echtzeit-Betriebsstatus angezeigt.

    Hinweis

    Das Senden einer Abbruchanfrage garantiert nicht, dass der Betrieb abgebrochen wird. Operationen, die den Status Abbrechen angefordert haben, können weiterhin ausgeführt werden, abhängig vom aktuellen Ausführungszustand des Agenten.

  • Gehe zu Operation: Öffne das Projekt in Studio und wähle die Operation aus. Diese Aktion ist nur für Studio-Operationen verfügbar, nicht für Design Studio-Operationen.

Wenn es mehr als 100 Operationen gibt, werden sie in Seiten mit jeweils etwa 100 aufgeteilt. Um verlinkte Operationsketten intakt zu halten, sind alle untergeordneten Operationen der letzten auf einer Seite angezeigten übergeordneten Operation auf dieser Seite enthalten, auch wenn die Gesamtzahl 100 überschreitet. Du kannst durch die Seiten navigieren, indem du diese Navigationsschaltflächen am unteren Ende der Tabelle verwendest:

• Vorherige Seite: Gehe zur vorherigen Seite.
• Nächste Seite: Gehe zur nächsten Seite.

Um die Details eines Protokolleintrags zu sehen, wähle einen in der Tabelle aus. Die Nachrichten und Protokolle-Leiste öffnet sich am unteren Rand des Fensters mit den folgenden Registerkarten, abhängig vom Protokolltyp:

• Benutzerdefinierte API, Proxy-API und OData-API Protokolleinträge: Nachrichten und Debug-Protokollierung.
• Operations Protokolleinträge: Nachrichten, Aktivitätsprotokolle, Debug-Dateien und Debug-Protokollierung.

Nachrichten-Registerkarte

Der Inhalt der Nachrichten-Registerkarte variiert je nach Protokolltyp des ausgewählten Eintrags.

API-Protokolleinträge

Wenn ein Benutzerdefinierte API, Proxy-API oder OData-API Protokolleintrag ausgewählt ist, zeigt die Nachrichten-Registerkarte Details zum API-Aufruf in den folgenden zusammenklappbaren Abschnitten an: API-Informationen, Aufrufinformationen, Aufrufprotokoll und API-Nutzlast (wenn aktiviert).

API-Informationen

Der Abschnitt API-Informationen zeigt die folgenden Details an:

• API: Der Name der API, die die Operation ausgelöst hat. Klicke auf , um die API-Konfiguration in einem neuen Tab im API-Manager zu öffnen.

• Version: Die Versionsnummer der API.

• API-Typ: Der Typ der API, einer der folgenden:

  • CUSTOM_API: Eine benutzerdefinierte API erstellt im API Manager.
  • ODATA: Eine OData API erstellt im API Manager.

• Anforderungsmethode: Die HTTP-Methode, die für den API-Aufruf verwendet wird. Mögliche Werte sind GET, POST, PUT, DELETE, PATCH und MERGE.

• API-Anforderungs-ID: Eine eindeutige Kennung für die API-Anforderung. Sie können diese ID verwenden, um Protokolle über verschiedene Systeme hinweg zu korrelieren und nach bestimmten Anforderungen zu suchen. Klicken Sie auf , um den Wert zu kopieren.

• Quell-IP: Die IP-Adresse der Client-Anwendung oder des Servers, der die API-Anforderung gestellt hat.

• API-Gateway: Das API-Gateway, das die Anfrage verarbeitet hat. Dieses Feld zeigt den Domainnamen entweder des Cloud-API-Gateways oder des privaten API-Gateways, das den API-Aufruf bearbeitet hat.

• API-Dienst-URL: Die vollständige URL für den Aufruf der API, einschließlich der Basis-URL, des Dienststammverzeichnisses, der Version und aller Pfadparameter. Dies ist die vollständige API-Dienst-URL, wie sie vom Client verwendet wird.

• Quellanwendung: Die Anwendung oder der Browser, der die API-Anforderung gestellt hat.

Aufrufinformationen

Der Abschnitt Aufrufinformationen zeigt die HTTP-Anforderungsheader an, die mit dem API-Aufruf unter dem Label Anforderungsheader gesendet wurden. Jeder Header wird als Schlüssel-Wert-Paar angezeigt, wie accept, accept_encoding, content_length, fulluri, host, user_agent und Weiterleitungsheader.

Aufrufprotokoll

Der Abschnitt Aufrufprotokoll zeigt systemweite Protokollnachrichten an, die während der Verarbeitung der API-Anforderung generiert wurden. Klicken Sie auf , um das Protokoll in Ihre Zwischenablage zu kopieren.

API-Nutzlast

Der Abschnitt API-Nutzlast zeigt die Anforderungs- und Antwortnutzlastdaten für den API-Aufruf an. Dieser Abschnitt ist sichtbar, wenn einer oder beide der folgenden Punkte im Einstellungs-Tab der API aktiviert sind: Debug-Modus aktivieren bis oder Anforderungs- und Antwortnutzlasten in Protokollen anzeigen.

Der Abschnitt ist in zwei Panels unterteilt:

• Anforderungstext: Die Nutzlast, die mit der API-Anforderung gesendet wird.

• Antworttext: Die Nutzlast, die von der API zurückgegeben wird. Wenn die Antwortnutzlast das Anzeige-Limit überschreitet, wird sie mit einem (Truncated)-Label angezeigt.

Jedes Panel bietet die folgenden Steuerungen:

• Suche: Durchsuchen Sie die Nutzlast nach einer bestimmten Zeichenfolge.

• Kopieren: Kopieren Sie die Nutzlast in Ihre Zwischenablage.

• Herunterladen: Laden Sie die Nutzlast als Datei herunter.

Protokolleinträge für Operationen

Wenn ein Operation-Protokolleintrag ausgewählt ist, zeigt der Nachrichten-Tab Folgendes an:

• Quell-Datensätze: Bei Verwendung einer FTP oder Datenbank Aktivität als Quelle wird die Anzahl der Datensätze angezeigt, die aus dem Quellsystem gelesen wurden. Bei anderen Konnektoren wird die Anzahl mit 0 angezeigt, unabhängig von der Anzahl der Quelldatensätze.

• Ziel-Datensätze: Bei Verwendung einer FTP oder Datenbank Aktivität als Ziel wird die Anzahl der Datensätze angezeigt, die an das Zielsystem gesendet wurden. Bei anderen Konnektoren wird die Anzahl mit 0 angezeigt, unabhängig von der Anzahl der Zieldatensätze.

• Nachricht: Protokolldetails, einschließlich einer der folgenden:

  • Systemgenerierte Nachrichten, die anzeigen, dass die Operation ohne Fehler abgeschlossen wurde.
  • Informations- und Warnmeldungen, die von den Quell- oder Zielsystemen zurückgegeben werden.
  • Validierungswarnungen, die von den Jitterbit-Transformations-, Validierungs- und Skript-Diensten zurückgegeben werden.
  • Benutzerdefinierte Nachrichten, die vom Invoke Operation Tool generiert werden (wenn Fehler auslösen, wenn die Operation fehlschlägt aktiviert ist) oder von der WriteToOperationLog() Funktion.

  Hinweis

  • Daten und Zeiten in Protokollnachrichten erscheinen im ursprünglichen Format der Quelle und werden nicht in die lokale Browserzeit umgewandelt.
  • Protokollnachrichten, die ~100 KB Größe (~99.000 Zeichen) überschreiten, werden gekürzt, was durch message truncated am Ende des Protokolls angezeigt wird.

  Klicken Sie auf , um zu kopieren, oder auf , um die Protokollnachrichten herunterzuladen.

• Nachrichten, die in Pre-Transformation-Skripten protokolliert werden: Nachrichten, die während der Ausführung von Pre-Transformation-Skripten generiert werden. Klicken Sie auf , um zu kopieren, oder auf , um herunterzuladen.

Um die Protokollnachrichten einer Operation im Nachrichten-Tab anzuzeigen, müssen die folgenden Bedingungen erfüllt sein:

• Sie müssen Mitglied einer Rolle mit mindestens Lesen-Berechtigung für die Organisation und Protokolle anzeigen-Zugriff auf die Umgebung sein.
• Cloud-Logging ist aktiviert für die private Agentengruppe. (Cloud-Logging ist immer für Cloud-Agentengruppen aktiviert.) Wenn es deaktiviert ist und Ihre Netzwerkkonfiguration es Ihnen ermöglicht, direkt mit dem Agenten-Host zu verbinden, können Protokollnachrichten sicher angezeigt werden, indem Sie auf den Link Protokollnachrichten vom Agenten anzeigen klicken.

Aktivitätsprotokolle-Tab

Dieser Tab enthält Links zu Erfolgs- oder Fehlerdateien, die von den Aktivitäten Salesforce, Salesforce Service Cloud oder ServiceMax erstellt wurden, die auf einem privaten Agenten ausgeführt werden.

Die Dateien liegen im CSV-Format vor. Um eine herunterzuladen, klicken Sie auf den entsprechenden Link.

Aktivitätsprotokolldateien werden nach 14 Tagen automatisch vom Dateireinigungsdienst des privaten Agenten gelöscht. Sie können dieses Verhalten im Abschnitt [ResultFiles] der Datei jitterbit.conf des privaten Agenten ändern oder die Regeln des Dateireinigungsdienstes anpassen.

Aktivitätsprotokolldownloads sind für Cloud-Agenten deaktiviert. Möglicherweise sehen Sie Download-Links für Aktivitätsprotokolle von Cloud-Agenten, aber der Versuch, Protokolle herunterzuladen, führt zu einer Fehlermeldung.

Debug-Dateien-Registerkarte

Wenn das Debug-Protokollieren für private Agenten aktiviert ist, enthält diese Registerkarte einen Link zum Herunterladen von Betriebs-Debug-Protokolldateien. Die Debug-Dateien werden standardmäßig nach 1 Tag entfernt oder gemäß den Bereinigungsregeln eines privaten Agenten konfiguriert.

Debug-Protokollierungs-Registerkarte

Wenn das Debug-Protokollieren auf Vorgangsebene (für Cloud-Agenten oder für private Agenten) aktiviert ist und der Vorgang auf einem Agenten der Version 10.48 oder höher ausgeführt wurde, zeigt diese Registerkarte die Details der vollständigen Ausführungs-Hierarchie eines Studio-Vorgangs an. Die Ansicht des Vorgangsprotokolls zeigt eine geteilte Ansicht mit Vorgangsprotokollen im linken Panel und detaillierten Protokollinformationen für den ausgewählten Vorgang im rechten Panel. Die Ansicht verwendet die ausgewählten Tabellensteuerungen, um die Ergebnisse zu filtern. Wenn Vorgänge mit Vorgangsaktionen oder der Funktion RunOperation verknüpft sind, werden diese Vorgänge unter dem übergeordneten Vorgang aufgelistet.

Wenn das Debug-Protokollieren für Vorgänge aktiviert ist, kann diese Registerkarte auch Komponenten-Eingabe- und Ausgabedaten sowie API-Anforderungs- und -Antwortdaten anzeigen (wenn der Vorgang durch eine API des API-Managers ausgelöst wird). Die Anforderungs- und Antwortpayloads sind nur enthalten, wenn Anforderungs- und Antwortpayloads in Protokollen anzeigen ebenfalls im Einstellungs-Tab der API aktiviert ist.

Elternoperationen (und alle darunter liegenden Kindoperationen) sind aufsteigend nach Begonnen sortiert. Die Tabelle kann (nur für Top-Level-Operationen) nach Name, Begonnen, Beendet, Dauer oder Status sortiert werden, indem auf die jeweilige Kopfzeile geklickt wird.

Wenn Sie die Ansicht des Operationsprotokolls öffnen, wird standardmäßig das erste Operationsprotokoll in der Liste ausgewählt. Die detaillierten Protokollinformationen für diese Operation erscheinen im rechten Bereich.

• Name: Der Name der Operation oder des Operationsschritts. Die Pfeile, die verwendet werden können, um zusätzliche Zeilen ein- oder auszublenden, werden bei Elternoperationen und bei Operationen angezeigt, für die Eingabe- und Ausgabedaten von Komponenten verfügbar sind:

  • Elternoperationen: Wenn eine Elternoperation erweitert wird, erscheinen zusätzliche Zeilen für ihre Kindoperationen in der Reihenfolge, in der sie ausgeführt wurden. Standardmäßig sind alle Elternoperationen erweitert. Verwenden Sie die Liste einklappen oder Liste ausklappen Symbole, um alle Elternoperationen ein- oder auszublenden.

• Begonnen: Das Datum und die Uhrzeit, zu der die Operation oder der Operation Schritt gestartet wurde, angezeigt als lokale Browserzeit.

• Beendet: Das Datum und die Uhrzeit, zu der die Operation oder der Operation Schritt gestoppt wurde, angezeigt als lokale Browserzeit.

• Dauer: Die Zeit, die zwischen Begonnen und Beendet vergangen ist, angegeben in Sekunden für Operationen und in Millisekunden für Operation Schritte.

• Status: Der Status der Operation oder des Operation Schrittes. Eine vollständige Liste möglicher Status finden Sie in der Tabelle mit Operationsdetails weiter oben auf dieser Seite.

• Aktionen: Diese Aktionen sind für Operationen (nicht für Operation Schritte) verfügbar:

  • Operation abbrechen: Aktiviert für Operationen, die sich im Status Eingereicht, Empfangen, Ausstehend oder Wird ausgeführt befinden. Operation abbrechen sendet eine Anfrage an den Agenten, um die Operation zu stoppen. Nach dem Klicken wird der Status Abbrechen angefordert neben dem Echtzeit-Operationsstatus angezeigt.

    Hinweis

    Das Senden einer Stornierungsanfrage garantiert nicht, dass die Operation abgebrochen wird. Operationen, die den Status Stornierung angefordert haben, können weiterhin ausgeführt werden, abhängig vom aktuellen Ausführungsstatus des Agents.

  • Gehe zur Operation: Öffne das Projekt in Studio und wähle die Operation aus.

• Aktualisieren: Klicke, um die Liste der Operationsprotokolle zu aktualisieren.

• Spalten filtern: Klicke, um ein Fenster zu öffnen, das es dir ermöglicht, die Spalten neu anzuordnen oder ihre Sichtbarkeit im Operationslistenpanel anzupassen:

  

  • Alle anzeigen: Alle Spalten sichtbar machen.

  • Verschieben: Ziehe und lasse los, um die Position der Spalte im Verhältnis zu anderen zu ändern.

  • Ausblenden: Die Spalte ist sichtbar. Klicke, um sie auszublenden.

  • Anzeigen: Die Spalte ist ausgeblendet. Klicke, um sie anzuzeigen.

• Spaltengröße ändern: Ziehe die Größenänderungs-Leiste einer Spalte, um sie zu ändern.

• Operationsprotokoll: Um ein Protokoll für eine einzelne Operation anzuzeigen oder auszublenden, klicke auf eine Operation aus der Liste.

  • Protokollnachrichten: Protokollnachrichten enthalten die Protokolldetails für die ausgewählte Operation. Ob Protokollnachrichten angezeigt werden, hängt von den Berechtigungen und Zugriffsrechten des aktuellen Benutzers ab und davon, ob das Cloud-Logging aktiviert ist. Weitere Informationen findest du im Abschnitt Nachrichtentab weiter oben auf dieser Seite.

    Hinweis

    Daten und Zeiten, die in den Protokollnachrichten selbst angezeigt werden, werden nicht in die lokale Browserzeit umgewandelt, sondern im ursprünglichen Format von der Quelle der Protokollnachricht angezeigt.

  • Kopieren: Kopiert die Protokolldaten in die Zwischenablage.

  • Herunterladen: Lädt die Protokollnachrichten als Textdatei herunter.
  • Anzeigen / Ausblenden: Zeigt oder blendet die Protokollnachrichten ein.

Eingabe- und Ausgabedaten der Komponente

Eingabe- und Ausgabedaten der Komponente werden generiert, wenn eine Operation das Debug-Logging auf Operationsebene aktiviert hat (für Cloud-Agents oder für private Agents) und die Operation auf einem Agenten der Version 10.48 oder höher ausgeführt wurde.

Wenn Eingabe- und Ausgabedaten für Komponenten vorhanden sind, wird eine grafische Darstellung des Vorgangs oder des Vorgangsschritts im Panel der Vorgangsliste angezeigt.

Symbole für Aktivitäten und Transformationen, die als Vorgangsschritte verwendet werden, werden angezeigt. Sie können auf einen Vorgangsschritt klicken, um die Eingabe- und Ausgabedaten für diesen einzelnen Vorgangsschritt anzuzeigen oder auszublenden. Jeder Eintrag im Eingabe- und Ausgabelog ist auf 100 MB begrenzt. Wenn die Daten für einen einzelnen Eintrag im Eingabe- oder Ausgabelog 100 MB überschreiten, werden keine Daten angezeigt.

• Suche: Suchen Sie die Daten nach dem eingegebenen Text.
• Kopieren: Kopiert die Protokolldaten in Ihre Zwischenablage.
• Herunterladen: Lädt die Eingabe- oder Ausgabedaten als Datei im entsprechenden Datenformat herunter. Die Datei wird mit dem Namen des Vorgangsschritts gefolgt von _input oder _output benannt, je nach Bedarf.

API-Anforderungs- und -Antwortdaten

Wenn eine Operation durch einen API-Manager benutzerdefinierte API oder OData-API ausgelöst wird, hängt die Menge der in den Betriebsprotokollen angezeigten Informationen von den aktivierten Einstellungen ab:

Um die Betriebs-Debug-Protokollierung zu aktivieren, siehe Betriebs-Debug-Protokollierung für Cloud-Agenten oder Betriebs-Debug-Protokollierung für private Agenten. Um Anforderungs- und Antwortpayloads anzuzeigen, aktivieren Sie Anforderungs- & Antwortpayloads in Protokollen anzeigen im Einstellungs-Tab der API.

API-Informationen

Das Betriebsprotokoll kann die folgenden Informationen für API-Aufrufe anzeigen:

• API: Der Name der API, die die Operation ausgelöst hat.

  • API im neuen Tab öffnen: Klicken Sie, um die API im API-Manager in einem neuen Tab zu öffnen.

• API-Typ: Dieses Feld kann einen der folgenden Typen haben:

  • CUSTOM_API: Eine benutzerdefinierte API, die im API-Manager erstellt wurde.
  • ODATA: Eine OData-API, die im API-Manager erstellt wurde.

• Anforderungsmethode: Die HTTP-Methode, die für den API-Aufruf verwendet wird. Mögliche Werte sind GET, POST, PUT, DELETE, PATCH und MERGE.

• API-Anforderungs-ID: Eine eindeutige Kennung für die API-Anforderung. Sie können diese ID verwenden, um Protokolle über verschiedene Systeme hinweg zu korrelieren und nach bestimmten Anforderungen zu suchen. Klicken Sie auf das Kopiersymbol, um den Wert zu kopieren.

• Quell-IP: Die IP-Adresse der Client-Anwendung oder des Servers, der die API-Anforderung gestellt hat.

• API-Gateway: Das API-Gateway, das die Anfrage verarbeitet hat. Dieses Feld zeigt den Domainnamen des Cloud-API-Gateways oder des privaten API-Gateways, das den API-Aufruf bearbeitet hat.

• API-Dienst-URL: Die vollständige URL zum Aufrufen der API, einschließlich der Basis-URL, des Dienststammverzeichnisses, der Version und aller Pfadparameter. Dies ist die vollständige API-Dienst-URL, wie sie vom Client verwendet wird.

• Quellanwendung: Die Anwendung oder der Browser, der die API-Anforderung gestellt hat.

Aufrufinformationen

Das Betriebsprotokoll zeigt einen Abschnitt Aufrufinformationen mit den HTTP-Anforderungsheadern, die mit dem API-Aufruf gesendet wurden. Jeder Header wird als Schlüssel-Wert-Paar angezeigt, wie accept, accept_encoding, content_length, fulluri, host, user_agent und Weiterleitungsheader.

Aufrufprotokoll

Das Betriebsprotokoll zeigt auch einen Abschnitt Aufrufprotokoll mit detaillierten Nachverfolgungsinformationen über die Verarbeitung der API-Anforderung. Diese Informationen können zur Fehlersuche bei API-Gateway-Problemen, Zeitüberschreitungsproblemen oder zum Verständnis des internen Verarbeitungsflusses der API verwendet werden. Der spezifische Inhalt des Aufrufprotokolls variiert je nach API-Konfiguration, Gateway-Einstellungen und ob während der Anforderungsverarbeitung Probleme aufgetreten sind.

Abfragen

Eine Abfrage besteht aus einem oder mehreren Schlüssel/Wert-Begriffen. Mehrere Begriffe werden durch Semikolons getrennt. Ein Begriff hat die Form <key><operator><value>. Für die Schlüssel operation, project, environment, agent und status können die Werte das Platzhalterzeichen % enthalten, das mit beliebigen Zeichenfolgen übereinstimmt. Sie können die Muster value% (beginnt mit), %value (endet mit) oder %value% (enthält) verwenden.

Um eine Abfrage zu verwenden, geben Sie eine gültige Abfragespezifikation in die Suchleiste ein und drücken Sie dann die Eingabetaste:

Wenn der Schalter Ausführungsbaumansicht aktiviert ist, gibt eine Abfrage Ergebnisse für die gesamte Ausführungskette eines übereinstimmenden Eintrags zurück: Bei einer Abfrage des Schlüssels operation umfassen die Ergebnisse die gesamte Hierarchie der übergeordneten und untergeordneten Operationen verknüpft mit der Operation sowie den übergeordneten API-Protokolleintrag, wenn die Operation durch einen API-Aufruf ausgelöst wurde. Der Schlüsselwort-String wird in den Ergebnissen blau hervorgehoben. Wenn der Schalter Ausführungsbaumansicht deaktiviert ist, werden nur die Einträge zurückgegeben, die direkt mit der Abfrage übereinstimmen.

Die folgende Tabelle zeigt die verfügbaren Komponenten der Abfragebegriffe:

Abfragebeispiele

Die folgenden sind Beispielabfragebegriffe:

Saved queries

Abfragen können gespeichert und verwendet sowie bearbeitet oder gelöscht werden, wie folgt:

• Um eine Abfrage zu speichern, klicken Sie auf Abfrage speichern. Das Abfrageformular öffnet sich:

  

  Geben Sie Werte für die folgenden Felder ein oder wählen Sie diese aus, und klicken Sie dann auf Speichern:

  • Name: Ein Name für die Abfrage.
  • Abfrage: Ein oder mehrere Abfragebegriffe unter Verwendung derselben Syntax wie die Suchleiste. Sie können Begriffe auf folgende Weise hinzufügen:
    • Klicken Sie auf das Feld, um eine Liste verfügbarer Suchbegriffe anzuzeigen. Wählen Sie einen aus, um ihn in das Abfragefeld einzugeben, und fügen Sie dann einen Operator und einen Wert hinzu.
    • Wählen Sie einen der Abfragevorschläge aus.
    • Geben Sie einen Abfragebegriff ein, gefolgt von einem Semikolon.

  • Spalten: Wählen Sie die Spalten aus, die in den Suchergebnissen angezeigt werden sollen.

    

  Nach dem Speichern öffnet sich das Formular Gespeicherte Abfragen:

  

  Klicken Sie auf Gespeicherte Abfragen, um es zu schließen.

• Um eine gespeicherte Abfrage zu verwenden, klicken Sie auf Gespeicherte Abfragen, und klicken Sie dann auf die Abfrage, die Sie ausführen möchten. Die Abfragebegriffe werden in die Abfragenzeile kopiert, und die Abfrage wird automatisch ausgeführt.

• Um eine gespeicherte Abfrage zu bearbeiten, klicken Sie auf Gespeicherte Abfragen, und klicken Sie auf das Bearbeiten-Symbol für die Abfrage, die Sie bearbeiten möchten. Die Abfrage öffnet sich im Abfrage bearbeiten-Bereich:

  

  Bearbeiten Sie die Abfrage und klicken Sie dann auf Speichern, um sie zu speichern, oder auf Abbrechen, um abzubrechen.

• Um eine gespeicherte Abfrage zu löschen, klicken Sie auf Gespeicherte Abfragen, und klicken Sie dann auf das Löschen-Symbol für die Abfrage, die Sie löschen möchten. Ein Dialogfeld Gespeicherte Abfrage löschen fordert Sie zur Bestätigung auf. Klicken Sie auf Löschen, um fortzufahren, oder auf Abbrechen, um abzubrechen.

Zeitbereich

Die Runtime-Seite gibt den Zeitraum an, der im Zeitbereichsmenü angezeigt wird:

Um den Zeitraum zu ändern, öffnen Sie das Menü und wählen Sie eine der folgenden Optionen aus:

• Letzte 24 Stunden

• Letzte 48 Stunden

• Letzte 72 Stunden

• Benutzerdefinierte Zeit: Wählen Sie aus, um den Dialog Benutzerdefinierte Zeit zu öffnen. Damit können Sie Vorgänge basierend auf den Daten für die Felder Begonnen und Beendet filtern:

  

  Klicken Sie auf das Kalendersymbol, um einen Datumswähler für ein Feld zu öffnen:

  

  Legen Sie entweder oder beide von- oder bis-Daten mit dem Kalender fest. Die Darstellung der Daten hängt von der Spracheinstellung Ihres Browsers ab.

  Um eine Uhrzeit festzulegen, geben Sie die Stunde und die Minute im Format HH:MM sowie den Zeitraum (AM oder PM) ein.

  Klicken Sie irgendwo im Dialog Benutzerdefinierte Zeit, um den Datumswähler zu schließen.

  Wenn entweder oder beide Datumsbereiche festgelegt sind, klicken Sie auf Übernehmen. Um den Bereich zu löschen, klicken Sie auf Löschen. Um die Daten eines Feldes zu löschen, klicken Sie auf das -Symbol.

Seiteneinstellungen

Sie können die Tabelle sortieren, ihre Spalten neu anordnen oder ihren Inhalt aktualisieren:

• Sortieren: Um die Tabelle in aufsteigender Reihenfolge zu sortieren, klicken Sie auf eine beliebige Spaltenüberschrift. Klicken Sie erneut, um die Sortierreihenfolge umzukehren.

• Spalten: Um die Anordnung und Sichtbarkeit der Spalten zu ändern, klicken Sie auf Spalten filtern. Die Schublade Spalten öffnet sich:

  

  Die Schublade enthält die folgenden Steuerungen:

  • Alle anzeigen: Alle Spalten sichtbar machen.
  • Verschieben: Ziehen und Ablegen, um die Position der Spalte im Verhältnis zu anderen zu ändern.
  • Ausblenden: Die Spalte ist sichtbar. Klicken Sie, um sie auszublenden.
  • Anzeigen: Die Spalte ist ausgeblendet. Klicken Sie, um sie anzuzeigen.
  • Speichern: Die Spalten speichern.
  • Abbrechen: Die Schublade für die Spalten schließen, ohne Änderungen zu speichern.

• Aktualisieren: Die Tabelle wird automatisch aktualisiert.

  Um das automatische Aktualisierungsintervall zu ändern, klicken Sie auf Einstellungen. Die Einstellungen-Leiste öffnet sich:

  

  Wählen Sie ein automatisches Aktualisierungsintervall aus, eines von Nie (der Standard), 1 Minute, 5 Minuten, 15 Minuten oder 30 Minuten, und klicken Sie dann auf die Schaltfläche Speichern.

  Um die Tabelle jederzeit zu aktualisieren, klicken Sie auf Aktualisieren.