Como resolvo o erro de cota de rastreamentos no X-Ray?

Breve descrição

Os cenários a seguir podem fazer com que os documentos de rastreamento excedam o limite permitido no AWS X-Ray:

• Você enviou um número maior de segmentos em lote para um rastreamento em que o tamanho do documento de rastreamento excede o tamanho de 500 KB.
• Você enviou segmentos não agrupados para um rastreamento em que o tamanho do documento de rastreamento excede 100 KB.
• Você adicionou segmentos, metadados e anotações personalizados que aumentaram o tamanho do documento de rastreamento.

O limite superior do tamanho de um documento de rastreamento do X-Ray muda dinamicamente de acordo com o número de segmentos que são enviados juntos. Isso se deve ao recurso de rastreamento de limite excedido. Para um grande número de segmentos que você envia juntos em um lote anexado a um rastreamento, o limite superior é de 500 KB. Para segmentos individuais que você envia com um intervalo de tempo vinculado a um rastreamento, o limite superior é de 100 KB.

Quanto mais rápido você enviar um rastreamento (quanto mais segmentos forem agrupados e enviados), mais a eficiência da compressão aumentará. Quanto mais lentamente você enviar um rastreamento (enviar segmentos individualmente com um intervalo de tempo), mais o rastreamento se dividirá em várias revisões. Além disso, quanto mais devagar você enviar um rastreamento, mais ele consumirá a capacidade de armazenamento do cache no back-end. Traços que duram mais produzem mais duplicatas e resultam na coleta de menos dados pelo X-Ray.

Resolução

**Observação:**Se você receber erros ao executar comandos da AWS Command Line Interface (AWS CLI), certifique-se de estar usando a versão mais recente da AWS CLI.

Visualize o rastreamento no console do X-Ray ou execute o seguinte comando para confirmar se o documento de rastreamento excede o limite de tamanho:

aws xray batch-get-traces --trace-ids <EXAMPLE_TRACE_ID>

Observação: substitua EXAMPLE\ _TRACE\ _ID pelo ID do seu rastreamento.

O X-Ray coleta as seguintes informações para um rastreamento maior:

{
    "Id": "<EXAMPLE_TRACE_ID>",
    "Duration": 187.859,
    "LimitExceeded": true,
    "Segments": [
         ...
     ]
     ....
 }

Observação: se o parâmetro LimitExceeded for true, significa que você excedeu a cota de rastreamento ou segmento.

Aumento do número de segmentos em lote para um rastreamento em que o tamanho do documento de rastreamento excede 500 KB

Esse cenário ocorre quando você integra o Step Functions ao X-Ray. Quando você integra o Step Functions ao X-Ray, não pode personalizar o que o X-Ray rastreia ou não. Quando você transmite o ID de rastreamento por todas as funções do AWS Lambda, os dados do segmento são adicionados a esse ID de rastreamento.

Se você estiver usando o Step Functions, conclua as seguintes etapas:

1. Vá para o Step Functions e desative o rastreamento ativo.
2. Transmita o ID de rastreamento pelas funções do Lambda somente para fluxos de trabalho críticos e não exceda o limite superior do rastreamento.
3. Se o Lambda estiver recebendo o cabeçalho de rastreamento de serviços upstream, remova a permissão PutTraceSegments da função de execução do Lambda. O limite superior é ajustado dinamicamente.

Se você não estiver usando o Step Functions, conclua as seguintes etapas:

1. Depure seu código para verificar se você está transmitindo o mesmo ID de rastreamento para solicitações diferentes.
2. Interrompa o rastreamento. Para fazer isso, não transmita o ID de rastreamento na invocação para serviços downstream.
3. Crie um novo ID de rastreamento a partir do ponto de interrupção.

Observação: se você criar um ID de rastreamento para cada aplicação, sua contagem de rastreamento aumentará. Para facilitar o rastreamento, mantenha os fluxos de trabalho essenciais das aplicações como parte de um único rastreamento.

Para obter mais informações, consulte AWS X-Ray e Step Functions.

Segmentos não agrupados para um rastreamento em que o tamanho do documento de rastreamento excede 100 KB

Para esse cenário, use a solução da seção anterior.

Interrompa rastreamentos para o novo limite superior de 100 KB. Ou agrupe mais segmentos na aplicação para aumentar o limite superior para 500 KB. O agrupamento de segmentos tem suporte somente com o SDK de telemetria aberta. Se você estiver usando o SDK do X-Ray, altere a forma como a aplicação envia segmentos.

Foram adicionados segmentos, metadados e anotações personalizados que aumentaram o tamanho do documento

Para reduzir o tamanho do documento de rastreamento, não adicione segmentos personalizados extras ao mesmo ID de rastreamento. Adicione segmentos personalizados somente para os fluxos de trabalho necessários. Além disso, para reduzir o tamanho do documento de rastreamento, reduza os metadados e as anotações nos rastreamentos.