Scrittura di informazioni nel registro eventi
È possibile monitorare la progressione dei differenti processi di business all'interno dell'applicazione BizTalk in uso scrivendo informazioni nel registro dell'applicazione predefinito o nel registro eventi personalizzato. Scrivere nel registro eventi può risultare utile nei casi seguenti:
Si desidera accedere ai messaggi dell'applicazione in modo standard utilizzando strumenti forniti da Windows.
Si desidera archiviare informazioni con altri messaggi dall'ambiente server per una più completa cronologia.
Si desidera avere la possibilità di monitorare l'applicazione utilizzando strumenti che interagiscono con il registro eventi.
Nota
Il metodo System.Diagnostics.EventLog.WriteEntry ha una limitazione relativa alle dimensioni della stringa di messaggio. Se la stringa di messaggio supera i 32.766 byte verrà generata un'eccezione.
Scrittura di informazioni nel registro dell'applicazione
È possibile scrivere nel registro applicazioni o in qualsiasi altro log dal codice usando System.Diagnostics.EventLog , come illustrato di seguito:
System.Diagnostics.EventLog.WriteEntry("Orchestration Debug", System.String.Format("The Value = {0}", iResult));
Analogamente, è anche possibile,
EventLog appLog = new EventLog();
appLog.Source = "This Application's Name";
appLog.WriteEntry("An entry to the Application event log.");
Se si usa un log personalizzato, è consigliabile usare il metodo SourceExists per assicurarsi che esista prima di scrivervi.
Scrittura in un registro personalizzato
La scrittura in un registro personalizzato è simile alla scrittura nel registro dell'applicazione con l'unica eccezione che è necessario creare prima il registro personalizzato. Il codice per creare un registro personalizzato è semplice:
// Create the source, if it does not already exist. if(!EventLog.SourceExists("MySource"))
{
//An event log source should not be created and immediately used.
//There is a latency time to enable the source, it should be created
//prior to executing the application that uses the source.
EventLog.CreateEventSource("MySource", "MyNewLog");
}
Tuttavia, non è scontato che il codice venga eseguito in un account con privilegi di sicurezza per creare un nuovo registro eventi. La creazione di un registro eventi implica privilegi di amministratore e deve essere eseguita con un programma di utilità separato oppure come parte di un'installazione msi. Per altre informazioni sull'uso di script personalizzati con un'installazione di .msi esportata, vedere Uso di script di pre-elaborazione e post-elaborazione per personalizzare la distribuzione dell'applicazione.