Rastreamentos de diagnóstico
Os rastreamentos são a publicação de mensagens específicas que são gerados durante a execução do aplicativo. Ao usar o rastreamento, você deve ter um mecanismo para coletar e registrar as mensagens são enviadas. Mensagens de rastreamento são recebidas por ouvintes. A finalidade de um ouvinte é coletar, armazenar e rotear mensagens de rastreamento. Os ouvintes direcionam a saída de rastreamento para um destino apropriado, como um log, uma janela ou um arquivo de texto.
Um ouvinte, o DefaultTraceListener, é criado e inicializado automaticamente quando o rastreamento está habilitado. Se desejar que a saída de rastreamento sejam direcionados para quaisquer outras fontes, você deve criar e inicializar ouvintes de rastreamento adicionais. Os ouvintes que você criar devem refletir suas necessidades individuais. Por exemplo, convém um registro de texto de toda a saída de rastreamento. Nesse caso, você criaria um ouvinte que escrevi todas as saídas para um novo arquivo de texto quando habilitado. Por outro lado, você talvez só queira exibir saída durante a execução do aplicativo. Nesse caso, você pode criar um ouvinte que direcionadas toda a saída para uma janela do console. O EventLogTraceListener pode direcionar a saída de rastreamento para um log de eventos e o TextWriterTraceListener pode gravar a saída de rastreamento em um fluxo.
Habilitar o rastreamento
Para habilitar rastreamentos durante o processamento de transações, você deve editar o arquivo de configuração do aplicativo. A seguir, é mostrado um exemplo.
<configuration>
<system.diagnostics>
<sources>
<source name="System.Transactions" switchValue="Warning">
<listeners>
<add name="tx"
type="System.Diagnostics.XmlWriterTraceListener"
initializeData= "tx.log" />
</listeners>
</source>
</sources>
</system.diagnostics>
</configuration>
System.Transactions os rastreamentos são gravados na origem chamada "System.Transactions". Você pode usar add para especificar o nome e o tipo do ouvinte de rastreamento que deseja usar. Em nosso exemplo de configuração, é chamado o ouvinte "tx" e adicionado o ouvinte de rastreamento padrão do .NET Framework (XmlWriterTraceListener) como o tipo que deseja usar. Use initializeData para definir o nome do arquivo de log para esse ouvinte. Além disso, você pode substituir um caminho totalmente qualificado para um nome de arquivo simples.
Cada tipo de mensagem de rastreamento é atribuído um nível para indicar o grau de importância. Se o nível de rastreamento do aplicativo-domínio for igual ou menor do que o nível de um tipo de evento, essa mensagem é gerada. O nível de rastreamento é controlado pelo switchValue configuração no arquivo de configuração. Os níveis que estão associados com as mensagens de rastreamento de diagnóstico são definidos na tabela a seguir.
| Nível de rastreamento: | Descrição |
|---|---|
| Crítico | Ocorreram falhas graves, como o seguinte: - Um erro que pode causar uma perda de imediata na funcionalidade do usuário. - Um evento que requer um administrador executar uma ação para evitar a perda de funcionalidade. - Paradas de código. - Esse nível de rastreamento também pode fornecer contexto suficiente para interpretar outros rastreamentos críticos. Isso pode ajudar a identificar a seqüência de operações que leva a uma falha grave. |
| Erro | Ocorreu um erro (por exemplo, inválido configuração ou da rede comportamento) que pode resultar em uma perda de funcionalidade do usuário. |
| Aviso | Existe uma condição que pode resultar em um erro ou uma falha crítica (por exemplo, alocação de falha ou alcançando o limite). O processamento normal de erros de código do usuário (por exemplo, transação anulada, tempos limite de falha de autenticação) também pode gerar um aviso. |
| Informações | São geradas Mensagens úteis para monitorar e diagnosticar o status do sistema, medir o desempenho ou criar perfis. Eles podem incluir eventos de tempo de vida de transação e a inscrição, como uma transação que está sendo criado ou confirmadas, a interseção de um limite significativa ou a alocação de recursos significativos. Um desenvolvedor pode utilizar essas informações para o gerenciamento de desempenho e planejamento de capacidade. |
Códigos de rastreamento
A tabela a seguir lista os códigos de rastreamento gerados pelo System.Transactions infra-estrutura. Incluído na tabela são o identificador de código de rastreamento, o nível de enumeração EventType para o rastreamento e os dados extras contidos no TraceRecord para o rastreamento. Além disso, o nível de rastreamento correspondente do rastreamento também é armazenado no TraceRecord.
| TraceCode | EventType | Dados extras em TraceRecord |
|---|---|---|
| TransactionCreated | Info | TransactionTraceId |
| TransactionPromoted | Info | TransactionTraceId local, TransactionTraceId distribuída |
| EnlistmentCreated | Info | TransactionTraceId, EnlistmentTraceId, EnlistmentType (duráveis voláteis), EnlistmentOptions |
| EnlistmentCallbackNegative | Aviso | TransactionTraceId, EnlistmentTraceId, Retorno de chamada (forcerollback/anulado/incertas) |
| TransactionRollbackCalled | Aviso | TransactionTraceId |
| TransactionAborted | Aviso | TransactionTraceId |
| TransactionInDoubt | Aviso | TransactionTraceId |
| TransactionScopeCreated | Info | TransactionScopeResult, que pode ser o seguinte: - Nova transação. - Transação passada. - Transação dependente passado. - Usando a transação atual. - Nenhuma transação. novo TransactionTraceId atual |
| TransactionScopeDisposed | Info | TransactionTraceId do escopo "esperado" da transação atual. |
| TransactionScopeIncomplete | Aviso | TransactionTraceId do escopo "esperado" da transação atual. |
| TransactionScopeNestedIncorrectly | Aviso | TransactionTraceId do escopo "esperado" da transação atual. |
| TransactionScopeCurrentTransactionChanged | Aviso | Antigo TransactionTraceId atual, outro TransactionTraceId |
| TransactionScopeTimeout | Aviso | TransactionTraceId do escopo "esperado" da transação atual. |
| DependentCloneCreated | Info | TransactionTraceId, tipo de transação dependente criado (RollbackIfNotComplete/BlockCommitUntilComplete) |
| DependentCloneComplete | Info | TransactionTraceId |
| RecoveryComplete | Info | Gerenciador de recursos de GUID (de base) |
| Reenlist | Info | Gerenciador de recursos de GUID (de base) |
| TransactionSerialized | Info | TransactionTraceId. |
| TransactionException | Erro | Mensagem de exceção |
| InvalidOperationException | Erro | Mensagem de exceção |
| InternalError | Crítico | Mensagem de exceção |
| TransferEvent | Quando uma transação é desserializada ou promovida de um System.Transactions transação para um distribuído, o ActivityID atual de ExecutionContext e a ID de transação distribuída são gravados. Quando o DTC chama de volta em código gerenciado, a ID de transação distribuída é definida como o ActivityID em ExecutionContext durante o retorno de chamada. |
|
| ConfiguredDefaultTimeoutAdjusted | Aviso | Nenhum dado extra |
| TransactionTimeout | Aviso | TransactionTraceId da transação que está sendo atingiu o tempo limite. |
O esquema XML para cada um dos itens de dados extras anterior tem o seguinte formato.
TransactionTraceIdentifier
<TransactionTraceIdentifier>
<TransactionIdentifier >
string representation of transaction id
</TransactionIdentifier>
< CloneIdentifier >
the clone id number
</CloneIdentifier>
</TransactionTraceIdentifier>
EnlistmentTraceIdentifier
<EnlistmentTraceIdentifier>
<ResourceManagerId>
string form of guid
</ResourceManagerId>
<TransactionTraceIdentifier>
<TransactionIdentifier >
string representation of transaction id
</TransactionIdentifier>
<CloneIdentifier >
the clone id number
</CloneIdentifier>
<TransactionTraceIdentifier>
<EnlistmentIdentifier>
the enlistment id number
</EnlistmentIdentifier>
</EnlistmentTraceIdentifier>
Identificador do Gerenciador de recursos
<ResourceManagerId>
string form of guid
</ResourceManagerId>
Problemas de segurança para rastreamento
Quando você como administrador ative o rastreamento, informações confidenciais podem gravadas em um log de rastreamento que podem ser exibido publicamente por padrão. Para minimizar qualquer possível ameaça à segurança, considere armazenar o log de rastreamento em um local seguro controlado por permissões de acesso de compartilhamento e arquivo de sistema.
