Abilitare e visualizzare i log di controllo delle operazioni di gestione comuni in BizTalk Server
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:
Aprire la Console di amministrazione BizTalk Server.
Fare clic con il pulsante destro del mouse su Gruppo BizTalk e quindi scegliere Impostazioni.
Selezionare Controlla operazioni di gestione.
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.
Selezionare OK per salvare le modifiche.
Se si desidera eseguire altre operazioni di gestione nella stessa sessione, aggiornare la console di amministrazione.
Visualizzare i log di controllo
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.
Per visualizzare i log di controllo, passare a
http://localhost/BizTalkOperationalDataService/AuditLogs.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-10http://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 ,
SendPortReceivePortoApplication.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.