Solucionar problemas de dados ausentes para o AWS Lambda com o OpenTelemetry

Problema: Métricas ou invocações do CloudWatch não estão aparecendo

Após instrumentar sua função do AWS Lambda com o OpenTelemetry e invocá-la, a seção CloudWatch metrics ou a aba Invocations não aparece na UI da New Relic.

Solução

O New Relic requer os seguintes atributos de recurso do OpenTelemetry para identificar e exibir corretamente sua função Lambda na UI:

Se esses atributos estiverem ausentes, defina-os usando a variável de ambiente OTEL_RESOURCE_ATTRIBUTES.

Template SAM:

yourFunctionHere:
  Type: AWS::Serverless::Function
  Properties:
    # ...
    Environment:
      Variables:
        OTEL_RESOURCE_ATTRIBUTES: "faas.name=my-lambda-function,faas.id=arn:aws:lambda:us-east-1:123456789012:function:my-lambda-function"

Console da AWS:

1. Abra sua função no Console do Lambda.
2. Escolha Configuration e depois Environment variables.
3. Escolha Edit e depois Add environment variable.
4. Defina Key para OTEL_RESOURCE_ATTRIBUTES e Value para faas.name=my-lambda-function,faas.id=arn:aws:lambda:us-east-1:123456789012:function:my-lambda-function.
5. Escolha Save.

Se você já tiver outros atributos de recurso definidos, adicione os novos valores como pares chave-valor separados por vírgula:

OTEL_RESOURCE_ATTRIBUTES=service.name=my-service,faas.name=my-lambda-function,faas.id=arn:aws:lambda:us-east-1:123456789012:function:my-lambda-function

Problema: ID da requisição ausente nos traces

Os traces da sua função Lambda aparecem no New Relic, mas o ID da solicitação da AWS não está visível no span raiz, dificultando a correlação dos traces com as entradas do CloudWatch Logs.

Solução

Defina o atributo faas.execution no span raiz dentro do seu handler. As convenções semânticas do OpenTelemetry definem este atributo como o ID de requisição ou invocação do provedor de nuvem.

Python:

from opentelemetry import trace

def handler(event, context):
    span = trace.get_current_span()
    span.set_attribute("faas.execution", context.aws_request_id)

    # Your handler logic here
    return {"statusCode": 200, "body": "OK"}

Node.js:

const { trace } = require('@opentelemetry/api');

exports.handler = async (event, context) => {
  const span = trace.getActiveSpan();
  if (span) {
    span.setAttribute('faas.execution', context.awsRequestId);
  }

  // Your handler logic here
  return { statusCode: 200, body: 'OK' };
};

Java:

import io.opentelemetry.api.trace.Span;

public class Handler implements RequestHandler<APIGatewayProxyRequestEvent, APIGatewayProxyResponseEvent> {
    @Override
    public APIGatewayProxyResponseEvent handleRequest(APIGatewayProxyRequestEvent event, Context context) {
        Span span = Span.current();
        span.setAttribute("faas.execution", context.getAwsRequestId());

        // Your handler logic here
        return new APIGatewayProxyResponseEvent().withStatusCode(200);
    }
}

Mais Informações

Para mais informações, consulte o seguinte:

• Rastreie suas funções Lambda em Java com o OpenTelemetry
• Rastreie suas funções .NET Lambda com o OpenTelemetry
• Início rápido do New Relic OpenTelemetry