Aktivieren und Anzeigen von Überwachungsprotokollen allgemeiner Verwaltungsvorgänge in BizTalk Server

  • Artikel

In BizTalk Server 2020 und höher können Administratoren einen Überwachungspfad von Verwaltungsvorgängen für Anwendungsartefakte generieren. Beispiele hierfür sind Vorgänge für Sendeports, Empfangsports, Empfangsstandorte, Orchestrierungen und Ressourcen. Sie können auch Vorgänge für Dienstinstanzen anhalten, fortsetzen und beenden.

Konfigurieren der Überwachung

Die Überwachung ist nicht standardmäßig konfiguriert. So aktivieren Sie die Überwachung

  1. Öffnen Sie die BizTalk Server-Verwaltungskonsole.

  2. Klicken Sie mit der rechten Maustaste auf BizTalk-Gruppe, und wählen Sie dann Einstellungen aus.

  3. Wählen Sie Überwachungsverwaltungsvorgänge aus.

  4. Geben Sie im Feld Maximale Anzahl von Überwachungseinträgen die Anzahl der Einträge ein, die Sie beibehalten möchten. Standardmäßig speichert BizTalk die 10.000 letzten Einträge.

  5. Klicken Sie auf OK, um die Änderungen zu speichern.

  6. Wenn Sie weitere Verwaltungsvorgänge in derselben Sitzung ausführen möchten, aktualisieren Sie die Verwaltungskonsole.

    Screenshot der Seite

Anzeigen von Überwachungsprotokollen

  1. Vergewissern Sie sich, dass der Betriebsdatendienst konfiguriert ist. Der Dienst sollte ein Konto verwenden, das Mitglied der Gruppen BizTalk Server Administratoren, BizTalk Server Operatoren oder BizTalk Server Schreibgeschützte Benutzer ist.

    Weitere Informationen finden Sie unter Konfigurieren der REST-APIs.

  2. Wechseln Sie zum Anzeigen von Überwachungsprotokollen zu http://localhost/BizTalkOperationalDataService/AuditLogs.

  3. Um Überwachungsprotokolleinträge aus einem bestimmten Datumsbereich anzuzeigen, verwenden Sie eines der folgenden Formate für die URL:

    • http://localhost/BizTalkOperationalDataService/AuditLogs?fromDate=<yyyy-MM-dd>&toDate=<yyyy-MM-dd>
    • http://localhost/BizTalkOperationalDataService/AuditLogs?fromDate=<yyyy-MM-dd>T<hh:mm:ss>&toDate=<yyyy-MM-dd>T<hh:mm:ss>

    Sie können beispielsweise eine der folgenden URLs verwenden:

    • http://localhost/BizTalkOperationalDataService/AuditLogs?fromDate=2022-05-01&toDate=2022-05-10
    • http://localhost/BizTalkOperationalDataService/AuditLogs?fromDate=2022-05-01T01:00:00&toDate=2022-05-10T01:00:00

Struktur des Überwachungsprotokolls

Ein Überwachungsprotokoll enthält die folgenden Informationen:

  • ID: Eine ID vom Typ Guid, die pro Eintrag eindeutig ist.

  • BatchId: Eine ID, die für alle überwachten Vorgänge, die Sie in einer einzelnen SQL-Transaktion ausführen, identisch ist. Dieser Wert kann Ihnen helfen, Benutzervorgänge mit Details auf niedrigerer Ebene zu korrelieren.

  • UserPrincipal: Der Benutzer, der den Vorgang ausgeführt hat, z. B jeffsmith@Fabricom.com. .

  • Computer: Der Name des Computers, auf dem der Vorgang ausgeführt wurde, z. B machine1@contoso.com. .

  • ArtifactId: Die eindeutige ID des Artefakts.

  • ParentArtifactId: Die ID des übergeordneten Artefakts, wenn das Artefakt ein untergeordnetes Element eines anderen Artefakts ist.

  • ArtifactType: Der Artefakttyp, für den der Vorgang ausgeführt wurde, z. B SendPort. , ReceivePortoder Application.

  • ArtifactName: Der Name des Artefakts. Dieser Wert wird vom Benutzer konfiguriert, z. B FTP send port. .

  • OperationName: Die Aktion, die für das Artefakt ausgeführt wurde, Createz. B. .

    In der folgenden Tabelle sind Vorgänge aufgeführt, die Sie für verschiedene Arten von Artefakten ausführen können:

    Artefakttyp Vorgangsnamen
    Port Create (Erstellen), Update (Aktualisieren), Delete (Löschen)
    Dienstinstanz Anhalten, Fortsetzen, Beenden
    Anwendungsressource Hinzufügen, Aktualisieren, Entfernen
    Bindungsdatei Importieren

  • Nutzlast: Informationen zu den Änderungen, die der Vorgang vorgenommen hat. Die Nutzlast ist im JSON-Format, z. B {"Description":"New description"}. .

  • CreatedDate: Der Zeitstempel des Vorgangs.

Wenn ein Artefakt erstellt oder aktualisiert wird, werden mindestens ein Überwachungseintrag protokolliert. Wenn beispielsweise ein Sendeport erstellt wird, werden Überwachungseinträge für jedes dieser Artefakte protokolliert:

  • Der Sendeport
  • Der primäre Transport
  • Der sekundäre Transport

Alle drei Einträge weisen dieselbe BatchId auf. Sie können die Werte ArtifactId und ParentArtifactId verwenden, um Überwachungsprotokolleinträge für primäre und sekundäre Transporte mit Sendeports zu korrelieren.

Nächste Schritte

Verfolgen und überwachen Sie die Integrität Ihrer BizTalk Server.