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 etwaige 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 Operationseinträ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 durch einen API-Aufruf ausgelöste Operationen oder Operation für direkt ausgeführte Operationen. (Gilt für alle Protokolltypen.)

• Umgebung: Der Name der Umgebung, in die 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.

    Tipp

    Eine extra subelement-Warnung in den Protokollnachrichten kann in der Regel 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: Die Operation wurde erfolgreich abgeschlossen, aber eine oder mehrere untergeordnete Operationen hatten fatale Fehler. (Gilt für synchrone Operationen.)

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

  Wenn eine Operation Betriebs-Debug-Protokollierung auf der Betriebsebene aktiviert hat und die Operation auf einem Agenten der Version 10.48 oder höher ausgeführt wurde, zeigt die Status-Spalte im Debug-Protokoll-Tab den Status des Betriebsschrittes an:

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

• Gestart: Die Zeit, zu der die Ausführung der Operation angefordert wurde. (Gilt für alle Protokolltypen.)

• Beendet: Die Zeit, zu der sich der Status der Operation 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 ausgeblendet standardmäßig.)

• 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 sich im Status Eingereicht, Erhalten, Ausstehend oder Läuft befinden. 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.
  • Gehe zu Betrieb: Öffnen Sie das Projekt in Studio und wählen Sie 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 diese in Seiten von jeweils etwa 100 aufgeteilt. Um verknüpfte Operationenketten intakt zu halten, werden alle untergeordneten Operationen der letzten auf einer Seite angezeigten übergeordneten Operation auf dieser Seite angezeigt, auch wenn die Gesamtzahl 100 überschreitet. Sie können durch die Seiten navigieren, indem Sie diese Navigationsschaltflächen am unteren Ende der Tabelle verwenden:

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

Um die Details eines Protokolleintrags anzuzeigen, wählen Sie 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:

• Custom API, Proxy API und OData API Protokolleinträge: Nachrichten und Debug-Protokollierung.
• Operation 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 Custom 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. Klicken Sie 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.

Anrufinformationen

Der Abschnitt Anrufinformationen 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 z. B. accept, accept_encoding, content_length, fulluri, host, user_agent und Weiterleitungsheader.

Anrufprotokoll

Der Abschnitt Anrufprotokoll 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 wurde.

• Antwortkörper: Die von der API zurückgegebene Nutzlast. 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.

Operation-Log-Einträge

Wenn ein Operation-Logeintrag 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 Skriptingdiensten 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 aus der Quelle und werden nicht in die lokale Browserzeit umgewandelt.
  • Protokollnachrichten, die ~100 KB in der Größe überschreiten (~99.000 Zeichen), werden gekürzt, was durch message truncated am Ende des Protokolls angezeigt wird.

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

• In Pre-Transformation-Skripten protokollierte Nachrichten: Nachrichten, die während der Ausführung von Pre-Transformation-Skripten generiert wurden. 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 der Berechtigung Lesen für die Organisation und dem Zugriff Protokolle anzeigen für 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 Konfigurationsdatei des privaten Agenten jitterbit.conf ändern oder die Regeln des Dateireinigungsdienstes anpassen.

Der Download von Aktivitätsprotokollen ist für Cloud-Agenten deaktiviert. Sie sehen möglicherweise Download-Links für Aktivitätsprotokolle von Cloud-Agenten, aber der Versuch, Protokolle herunterzuladen, erzeugt eine Fehlermeldung.

Debug-Dateien-Tab

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

Debug-Logging-Registerkarte

Wenn das Debug-Logging auf der Ebene der Operation (für Cloud-Agenten oder für private Agenten) aktiviert ist und die Operation auf einem Agenten der Version 10.48 oder höher ausgeführt wurde, zeigt diese Registerkarte die Details der vollständigen Ausführungs-Hierarchie einer Studio-Operation an. Die Ansicht des Operation-Protokolls zeigt eine geteilte Ansicht mit den Protokollen der Operation im linken Bereich und detaillierten Protokollinformationen für die ausgewählte Operation im rechten Bereich. Die Ansicht verwendet die ausgewählten Tabellensteuerungen, um die Ergebnisse zu filtern. Wenn Operationen mit Operationsaktionen oder der Funktion RunOperation verknüpft sind, werden diese Operationen unter der übergeordneten Operation aufgelistet.

Wenn das Debug-Logging für Operationen aktiviert ist, kann diese Registerkarte auch Komponenten-Eingabe- und Ausgabedaten sowie API-Anforderungs- und Antwortdaten anzeigen (wenn die Operation durch eine API des API-Managers ausgelöst wird). Die Anforderungs- und Antwortpayloads sind nur enthalten, wenn Anforderungs- und Antwortpayloads in Protokollen anzeigen ebenfalls in der Registerkarte Einstellungen der API aktiviert ist.

Übergeordnete Operationen (und alle darunter liegenden untergeordneten Operationen) werden aufsteigend nach Begonnen sortiert. Die Tabelle kann (nur für übergeordnete Operationen) nach Name, Begonnen, Beendet, Dauer oder Status sortiert werden, indem auf die jeweilige Kopfzeile geklickt wird.

Wenn Sie die Ansicht des Betriebsprotokolls öffnen, wird standardmäßig das erste Betriebsprotokoll in der Liste ausgewählt. Die detaillierten Protokollinformationen für diesen Betrieb erscheinen im rechten Bereich.

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

  • Übergeordnete Betriebe: Wenn ein übergeordneter Betrieb erweitert wird, erscheinen zusätzliche Zeilen für seine untergeordneten Betriebe in der Reihenfolge, in der sie ausgeführt wurden. Standardmäßig sind alle übergeordneten Betriebe erweitert. Verwenden Sie die Liste einklappen oder Liste ausklappen Symbole, um alle übergeordneten Betriebe ein- oder auszublenden.

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

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

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

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

• Aktionen: Diese Aktionen sind für Betriebe verfügbar (nicht für Betriebsschritte):

  • Betrieb abbrechen: Aktiviert für Betriebe, die sich im Status Eingereicht, Empfangen, Ausstehend oder Wird ausgeführt befinden. 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

    Betriebe, die den Status Abbrechen angefordert haben, können weiterhin ausgeführt werden.

  • Zum Betrieb gehen: Öffnen Sie das Projekt in Studio und wählen Sie den Betrieb aus.

• Aktualisieren: Klicken Sie, um die Liste der Betriebsprotokolle zu aktualisieren.

• Spalten filtern: Klicken Sie, um eine Schublade zu öffnen, die es Ihnen ermöglicht, die Spalten neu anzuordnen oder deren Sichtbarkeit im Betriebslistenpanel anzupassen:

  

  • 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.

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

• Betriebsprotokoll: Um ein Protokoll für einen einzelnen Betrieb anzuzeigen oder auszublenden, klicken Sie auf einen Betrieb in der Liste.

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

    Hinweis

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

  • Kopieren: Kopiert die Protokolldaten in Ihre Zwischenablage.

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

Eingabe- und Ausgabedaten der Komponente

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

Um die Generierung von Eingabe- und Ausgabedaten von Komponenten in einer privaten Agentengruppe zu deaktivieren, setzen Sie in der Konfigurationsdatei des privaten Agents im Abschnitt [VerboseLogging] verbose.logging.enable=false.

Wenn Eingabe- und Ausgabedaten von 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 Ausgabenprotokoll ist auf 100 MB begrenzt. Wenn die Daten für einen einzelnen Eintrag im Eingabe- oder Ausgabenprotokoll 100 MB überschreiten, werden keine Daten angezeigt.

• Suchen: 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 von einem API-Manager benutzerdefinierten 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 an, 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 an, die mit dem API-Aufruf gesendet wurden. Jeder Header wird als Schlüssel-Wert-Paar angezeigt, wie z. B. 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 an. 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 die mit der Operation verknüpft sind, 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. Der 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: Spalten speichern.
  • Abbrechen: Schließen Sie die Spaltenschublade, ohne Änderungen zu speichern.

• Aktualisieren: Die Tabelle wird automatisch aktualisiert.

  Um das automatische Aktualisierungsintervall zu ändern, klicken Sie auf Einstellungen. Der Einstellungen-Bereich ö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.