As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Solicitar rastreamento para seu Application Load Balancer
<a name="load-balancer-request-tracing"></a>

Quando o load balancer recebe uma solicitação de um cliente, ele adiciona ou atualiza o cabeçalho **X-Amzn-Trace-Id**, antes de enviar a solicitação ao destino. Todos os serviços ou aplicativos entre o load balancer e o destino também podem adicionar ou atualizar esse cabeçalho.

Você pode usar o rastreamento de solicitação para rastrear solicitações HTTP de clientes para destinos ou outros serviços. Se você habilitar os logs de acesso, o conteúdo do cabeçalho **X-Amzn-Trace-Id** será registrado. Para obter mais informações, consulte [Logs de acesso para seu Application Load Balancer](load-balancer-access-logs.md).

## Sintaxe
<a name="request-tracing-syntax"></a>

O cabeçalho **X-Amzn-Trace-Id** contém campos com o seguinte formato:

```
Field=version-time-id
```

*Campo*  
O nome do campo. Os valores suportados são `Root` e `Self`.  
um aplicativo pode adicionar campos arbitrários para as suas próprias finalidades. O load balancer preserva esses campos, mas não os usa.

*version*  
O número da versão. Este valor é 1.

*horário*  
A hora de referência (epoch), em segundos. Esse valor tem 8 dígitos hexadecimais.

*id*  
O identificador de rastreamento. Esse valor tem 24 dígitos hexadecimais.

**Exemplos**  
Se o cabeçalho **X-Amzn-Trace-Id** não estiver presente em uma solicitação de entrada, o load balancer deverá gerar um cabeçalho com o campo `Root` e encaminhar a solicitação. Por exemplo:

```
X-Amzn-Trace-Id: Root=1-67891233-abcdef012345678912345678
```

Se o cabeçalho **X-Amzn-Trace-Id** estiver presente e contiver um campo `Root`, o load balancer inserirá um campo `Self` e encaminhará a solicitação. Por exemplo:

```
X-Amzn-Trace-Id: Self=1-67891233-12456789abcdef012345678;Root=1-67891233-abcdef012345678912345678
```

Se um aplicativo adicionar um cabeçalho com um campo `Root` e um campo personalizado, o load balancer preservará os dois campos, inserirá um campo `Self` e encaminhará a solicitação:

```
X-Amzn-Trace-Id: Self=1-67891233-12456789abcdef012345678;Root=1-67891233-abcdef012345678912345678;CalledFrom=app
```

Se o cabeçalho **X-Amzn-Trace-Id** estiver presente e contiver um campo `Self`, o load balancer atualizará o valor do campo `Self`.

## Limitações
<a name="request-tracing-limits"></a>
+ O load balancer atualiza o cabeçalho quando recebe uma solicitação recebida, não quando recebe uma resposta.
+ Se os cabeçalhos HTTP tiverem mais de 7 KB, o load balancer reescreverá o cabeçalho **X-Amzn-Trace-Id** com um campo `Root`.
+ Com WebSockets, você pode rastrear somente até que a solicitação de upgrade seja bem-sucedida.