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á. # Adicionar anotações e metadados aos segmentos com o X-Ray SDK para .NET **nota** Aviso de SDK/Daemon manutenção do X-Ray — Em 25 de fevereiro de 2026, o AWS X-Ray SDKs/Daemon entrará no modo de manutenção, onde AWS limitará as versões do X-Ray SDK e do Daemon para tratar apenas de problemas de segurança. Para obter mais informações sobre a linha do tempo do suporte, consulte [Cronograma de suporte do X-Ray SDK e do Daemon Support](xray-sdk-daemon-timeline.md). Recomendamos migrar para o. OpenTelemetry Para obter mais informações sobre a migração para OpenTelemetry, consulte [Migrando da instrumentação X-Ray para a instrumentação](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-migration.html). OpenTelemetry Você pode registrar informações adicionais sobre solicitações, o ambiente ou o aplicativo com anotações e metadados. Também é possível adicionar anotações e metadados aos segmentos que o X-Ray SDK cria ou aos subsegmentos personalizados que você cria. **Anotações** são pares de chave-valor com valores boolianos, de string ou número. As anotações são indexadas para serem usadas com [expressões de filtro](xray-console-filters.md). Use anotações para registrar dados que você deseja usar para agrupar rastreamentos no console ou ao chamar a API [https://docs.aws.amazon.com/xray/latest/api/API_GetTraceSummaries.html](https://docs.aws.amazon.com/xray/latest/api/API_GetTraceSummaries.html). **Metadados** são pares chave-valor que podem ter valores de qualquer tipo, incluindo objetos e listas, mas não são indexados para uso com expressões de filtro. Use metadados para registrar dados adicionais que você deseja armazenar no rastreamento e não precisa usar com a pesquisa. **Topics** + [Registrar anotações com o X-Ray SDK para .NET](#xray-sdk-dotnet-segment-annotations) + [Registrar metadados com o X-Ray SDK para .NET](#xray-sdk-dotnet-segment-metadata) ## Registrar anotações com o X-Ray SDK para .NET Use anotações para registrar informações em segmentos ou subsegmentos que você deseja indexar para pesquisa. O seguinte é necessário para todas as anotações no X-Ray: **Requisitos de anotação** + **Chaves**: a chave para uma anotação do X-Ray pode ter até 500 caracteres alfanuméricos. Você não pode usar espaços ou símbolos que não sejam um ponto (.) + **Valores**: o valor de uma anotação do X-Ray pode ter até 1.000 caracteres Unicode. + O número de **anotações**: você pode usar até cinquenta anotações por rastreamento. **Para gravar anotações fora de uma função AWS Lambda** 1. Obtenha uma instância do `AWSXRayRecorder`. ``` using [Amazon.XRay.Recorder.Core](https://docs.aws.amazon.com/xray-sdk-for-dotnet/latest/reference/html/N_Amazon_XRay_Recorder_Core.htm); ... AWSXRayRecorder recorder = AWSXRayRecorder.Instance; ``` 1. Chame `addAnnotation` com uma chave de string e um booliano, Int32, Int64, Double ou valor de string. ``` recorder.AddAnnotation("mykey", "my value"); ``` O exemplo a seguir mostra como chamar `putAnnotation` com uma chave String que inclui um ponto e um valor booliano, numérico ou de string. ``` document.putAnnotation("testkey.test", "my value"); ``` **Para gravar anotações dentro de uma função AWS Lambda** Tanto os segmentos quanto os subsegmentos dentro de uma função do Lambda são gerenciados pelo ambiente de runtime do Lambda. Para adicionar uma anotação a um segmento ou subsegmento dentro de uma função do Lambda, faça o seguinte: 1. Crie o segmento ou subsegmento dentro da função do Lambda. 1. Adicione a anotação ao segmento ou subsegmento. 1. Finalize o segmento ou subsegmento. O exemplo de código a seguir mostra como adicionar uma anotação a um subsegmento dentro de uma função do Lambda: ``` #Create the subsegment AWSXRayRecorder.Instance.BeginSubsegment("custom method"); #Add an annotation AWSXRayRecorder.Instance.AddAnnotation("My", "Annotation"); try { YourProcess(); #Your function } catch (Exception e) { AWSXRayRecorder.Instance.AddException(e); } finally #End the subsegment { AWSXRayRecorder.Instance.EndSubsegment(); } ``` O X-Ray SDK registra anotações como pares de chave-valor em um objeto `annotations` no documento de segmentos. Chamar a operação `addAnnotation` duas vezes com a mesma chave substitui um valor registrado anteriormente no mesmo segmento ou subsegmento. Para encontrar rastreamentos que têm anotações com valores específicos, use a palavra-chave `annotation[key]` em uma [expressão de filtro](xray-console-filters.md). ## Registrar metadados com o X-Ray SDK para .NET Use metadados para registrar informações em segmentos ou subsegmentos os quais você não precisa indexar para uso em uma pesquisa. Valores de metadados podem ser strings, números, boolianos ou outro objeto que possa ser serializado em uma matriz ou objeto JSON. **Como registrar metadados** 1. Obtenha uma instância de `AWSXRayRecorder`, conforme mostrado no seguinte exemplo de código: ``` using [Amazon.XRay.Recorder.Core](https://docs.aws.amazon.com/xray-sdk-for-dotnet/latest/reference/html/N_Amazon_XRay_Recorder_Core.htm); ... AWSXRayRecorder recorder = AWSXRayRecorder.Instance; ``` 1. Chame `AddMetadata` com um namespace de string, uma chave de string e um valor de objeto, conforme mostrado no exemplo de código a seguir: ``` recorder.AddMetadata("my namespace", "my key", "my value"); ``` Você também pode chamar a operação `AddMetadata` usando apenas um par de chave e valor, conforme mostrado no seguinte exemplo de código: ``` recorder.AddMetadata("my key", "my value"); ``` Se você não especificar um valor para o namespace, o X-Ray SDK usará `default`. Chamar a operação `AddMetadata` duas vezes com a mesma chave substitui um valor registrado anteriormente no mesmo segmento ou subsegmento.