Abilitare e visualizzare i log di controllo delle operazioni di gestione comuni in BizTalk Server

  • Articolo

In BizTalk Server 2020 e versioni successive gli amministratori possono generare un audit trail delle operazioni di gestione sugli artefatti dell'applicazione. Gli esempi includono operazioni su porte di trasmissione, porte di ricezione, posizioni di ricezione, orchestrazioni e risorse. È anche possibile controllare le operazioni di sospensione, ripresa e interruzione nelle istanze del servizio.

Configurare il controllo

Il controllo non è configurato per impostazione predefinita. Per attivare il controllo:

  1. Aprire la Console di amministrazione BizTalk Server.

  2. Fare clic con il pulsante destro del mouse su Gruppo BizTalk e quindi scegliere Impostazioni.

  3. Selezionare Controlla operazioni di gestione.

  4. Nella casella Numero massimo di voci di controllo immettere il numero di voci che si desidera conservare. Per impostazione predefinita, BizTalk archivia le 10.000 voci più recenti.

  5. Selezionare OK per salvare le modifiche.

  6. Se si desidera eseguire altre operazioni di gestione nella stessa sessione, aggiornare la console di amministrazione.

    Screenshot della pagina Gruppo nella console di amministrazione di BizTalk Server. Vengono evidenziate le operazioni di gestione dei controlli e la casella numero massimo di voci.

Visualizzare i log di controllo

  1. Verificare che il servizio dati operativo sia configurato. Il servizio deve usare un account membro degli amministratori di BizTalk Server, gli operatori BizTalk Server o i gruppi di utenti di sola lettura BizTalk Server.

    Per altre informazioni, vedere Configurare le API REST.

  2. Per visualizzare i log di controllo, passare a http://localhost/BizTalkOperationalDataService/AuditLogs.

  3. Per visualizzare le voci del log di controllo da un intervallo di date specifico, usare uno di questi formati per l'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>

    Ad esempio, è possibile usare uno di questi URL:

    • 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

Struttura del log di controllo

Un log di controllo contiene le informazioni seguenti:

  • ID: ID di tipo Guid, univoco per voce.

  • BatchId: ID che corrisponde a tutte le operazioni controllate eseguite in una singola transazione SQL. Questo valore consente di correlare le operazioni utente con dettagli di livello inferiore.

  • UserPrincipal: l'utente che ha eseguito l'operazione, ad esempio jeffsmith@Fabricom.com.

  • Computer: nome del computer su cui è stata eseguita l'operazione, ad esempio machine1@contoso.com.

  • ArtifactId: ID univoco dell'artefatto.

  • ParentArtifactId: ID dell'artefatto padre, se l'artefatto è figlio di un altro artefatto.

  • ArtifactType: tipo di artefatto su cui è stata eseguita l'operazione, ad esempio , SendPortReceivePorto Application.

  • ArtifactName: nome dell'artefatto. Questo valore viene configurato dall'utente, ad esempio FTP send port.

  • OperationName: azione eseguita sull'artefatto, Createad esempio .

    Nella tabella seguente sono elencate le operazioni che è possibile eseguire su diversi tipi di artefatti:

    Tipo di artefatto Nomi delle operazioni
    Porta Create, Update, Delete
    Istanza del servizio Suspend, Resume, Terminate
    Risorsa dell'applicazione Aggiungere, aggiornare, rimuovere
    File di associazione Importa

  • Payload: informazioni sulle modifiche apportate dall'operazione. Il payload è in formato JSON, {"Description":"New description"}ad esempio .

  • CreatedDate: timestamp dell'operazione.

Quando viene creato o aggiornato un artefatto, vengono registrate una o più voci di controllo. Ad esempio, quando viene creata una porta di trasmissione, le voci di controllo vengono registrate per ognuno di questi artefatti:

  • Porta di trasmissione
  • Trasporto primario
  • Trasporto secondario

Tutte e tre le voci hanno lo stesso BatchId. È possibile usare i valori ArtifactId e ParentArtifactId per correlare le voci del log di controllo per i trasporti primari e secondari con le porte di trasmissione.

Passaggi successivi

Tenere traccia e monitorare l'integrità del BizTalk Server.