Actualización del manejo OTLP de New Relic de atributos largos

Estamos ajustando nuestra lógica de validación de ingesta OTLP para que sea menos estricta cuando encontremos valores de atributos largos.

El extremo OTLP New Relic tiene una variedad de límites de atributos. Actualmente, si envía a New Relic un span, métrica o traza OTLP con un atributo de cadena que excede el límite de longitud de 4095 caracteres, se genera un NrIntegrationError y se descarta todo el registro.

Esta es la causa más común de falta de datos. Afortunadamente, hay una solución fácil:

En lugar de descartar registros que violen este límite, simplemente truncaremos el atributo long a 4095 caracteres.

Implementaremos este cambio el 2 de junio de 2025.

¿Cómo me afectará esto?

Creemos que esto será un alivio bienvenido en casi todos los casos. Puede resultar difícil rastrear y diagnosticar los datos faltantes, especialmente en entornos con una gran cantidad de implementaciones gestionadas por muchos equipos individuales. Con este cambio, el extremo OTLP New Relic reflejará mejor nuestra filosofía de "almacena lo que envías" y tendrá un error menos común.

Sin embargo, dado el modelo de precios basado en el uso de New Relic, este cambio significa que los registros que anteriormente se descartaban por exceder los límites ahora se almacenarán y contribuirán al uso de datos de su cuenta.

Si está siguiendo nuestra documentación OTLP extremo sobre los límites de atributos, no hay nada que hacer. Cumplir con los límites de los atributos significa que actualmente no se están descartando datos y, por lo tanto, no se almacenarán datos adicionales.

Para verificar si actualmente se están descartando datos de su cuenta debido a que se excede el límite de longitud del atributo, ejecute la siguiente consulta NRQL:

FROM NrIntegrationError SELECT * WHERE message like 'One or more OTLP data point(s) was dropped because the length of an attribute value was over the limit.

Si esta consulta devuelve resultados, es posible que observe un cambio en el uso y, por lo tanto, en la facturación luego de este cambio. La cantidad exacta depende de la frecuencia con la que los registros violan los límites. Consulta la sección de mitigación para obtener consejos sobre cómo compensar cualquier uso de datos adicional en el que puedas incurrir.

Mitigación

Parte de la propuesta de valor principal de OpenTelemetryes proporcionar herramientas para tomar el control de su flujo telemetry data . Como tal, hay una variedad de herramientas disponibles para ayudar a mitigar un cambio en el uso de datos. Para obtener una discusión completa, consulte Gestionar el volumen de ingesta de datos de OpenTelemetry. Algunas estrategias son particularmente relevantes aquí:

• Truncar atributo largo
• Eliminar el atributo ofensivo
• Envíe menos registros con ejemplificación

Truncar atributo largo

Aprovechando el procesador de transformación del recolector y el editor truncate_all , trunca todos los atributos hasta un límite conocido, como se muestra aquí. Esto es lo que hará el extremo OTLP New Relic luego de este cambio. Sin embargo, puede aprovechar esta técnica para compensar un cambio en el uso estableciendo un límite inferior que los límites de la plataforma New Relic. Por ejemplo, puede establecer un límite de 1000 si cree que solo necesitará los primeros 1000 caracteres para su caso de uso de observabilidad.

transform:
  trace_statements:
    - truncate_all(span.attributes, 4095)
    - truncate_all(resource.attributes, 4095)
  log_statements:
    - truncate_all(log.attributes, 4095)
    - truncate_all(resource.attributes, 4095)
  metric_statements:
    - truncate_all(datapoint.attributes, 4095)
    - truncate_all(resource.attributes, 4095)

Eliminar el atributo ofensivo

Aprovechando el procesador de transformación del recolector y el editor delete_key , elimine los atributos que no son valiosos:

transform:
  trace_statements:
    - delete_key(span.attributes, "attribute.key.to.drop")
  log_statements:
    - delete_key(log.attributes, "attribute.key.to.drop")
  metric_statements:
    - delete_key(datapoint.attributes, "attribute.key.to.drop")

Puede optar por eliminar claves de atributos que sean particularmente largas y que, por lo tanto, contribuyan demasiado al uso, o atributos que sean cortos pero que simplemente no sean normalmente útiles. Como referencia, la siguiente lista resume los 10 atributos más comunes que violan el límite de longitud:

• exception.stactrace
• other - un comodín para atributo personalizado no definido en las convenciones semánticas OpenTelemetry
• db.statement
• process.command_line
• graphql.document
• db.operation
• db.query.text
• http.url
• exception.message
• http.target

Envíe menos registros con ejemplificación

Compensa los datos adicionales ajustando tu frecuencia de ejemplificación empleando cualquiera de las estrategias que se analizan aquí.