Utilice etiqueta para ayudar a organizar y encontrar sus datos

Aplicamos automáticamente cierta etiqueta a la entidad que incluye información de la cuenta. Estas etiquetas incluyen:

• account
• accountId

El agente New Relic se puede configurar para aplicar una etiqueta a la entidad creada a partir de sus datos. Las opciones de configuración son algo específicas del agente, pero generalmente usan la tecla labels . Algunos ejemplos:

• Configuración de etiquetas de agente de Java

• Configuración de etiqueta de agente .NET

  Las etiquetas aplicadas desde la configuración del agente APMpueden generar múltiples valores para una clave de etiqueta determinada en una entidad determinada, porque cada instancia de desplegar del agente podría configurarse para enviar un valor diferente.

El agente New Relic aplica automáticamente cierta etiqueta a la entidad de servicio según el entorno. Estos incluyen (pero no se limitan a):

• Para entidad de servicio/aplicación

  • language: (por ejemplo, java o python)

• Para entidad anfitriona

  • awsRegion, cuando sea aplicable

  Si está utilizando uno de nuestros proveedores de integración en la nube (AWS, Azure o Google Cloud Platform), le recomendamos instalar el agente de infraestructura en sus hosts: esto agregará una etiqueta de entorno de nube a su entidad de host de monitor en New Relic.

Ciertos atributos de recursos de OpenTelemetry se aplican automáticamente como etiqueta de entidad. Cuando los siguientes atributos estén presentes en los datos de tramo asociados con una entidad de servicio, se adjuntarán a esa entidad:

• k8s.cluster.name

• k8s.deployment.name

• k8s.namespace.name

• telemetry.sdk.language: Se almacenará como una etiqueta denominada language

• telemetry.sdk.version

• service.namespace

  Esta etiqueta automatizada se realiza mediante la síntesis de entidad New Relic, que está documentada en GitHub. En el caso de los servicios OpenTelemetry, las definiciones de etiquetas están en ext-service entidad.

1. Navegue hasta una condición.

2. Cerca del nombre de la condición en la parte superior del formulario, haga clic en Manage tags.

3. En el menú que aparece, agregue o elimine una etiqueta.

   También puede agregar una etiqueta a una condición de alerta como una entidad a través de la API NerdGraph (utilice el GUID de la entidad de la condición desde la pantalla 'administrar etiqueta').

   Consulte nuestro tutorial para obtener más información sobre los datos de etiquetas a través de la API NerdGraph.

Para obtener una guía para automatizar etiquetas utilizando nuestra herramienta CLI, consulte nuestro sitio para desarrolladores.

• La UI tiene límites en la cantidad total de etiquetas que puede mostrar por entidad:

  • Límite de 100 para la etiqueta informada de forma predeterminada o agregada mediante la configuración del agente/integración.
  • Límite de 100 para etiquetas personalizadas agregadas mediante UI o API.

• La siguiente es la longitud máxima de caracteres para la etiqueta:

  • Clave: 128 caracteres
  • Valor: 256 caracteres

• Caracteres permitidos:

  • Los caracteres deben ser UTF-8.
  • Cuando se utiliza NerdGraph para agregar etiquetas, un guión - en una clave de etiqueta se interpreta como un símbolo menos. Si la clave de su etiqueta tiene un guión, use marcas inversas alrededor, como `key-name`.

Algunos consejos para mantener la etiqueta simple:

• Comience agregando solo la etiqueta que sabe que definitivamente usará. Las etiquetas no utilizadas crean ruido y pueden generar confusión.

• Intente utilizar una etiqueta corta. Las etiquetas más cortas son más fáciles de analizar y, además, la UI a veces puede truncar las etiquetas más largas. (Ver límites de caracteres).

• Cuando sea posible, utilice claves y valores que sean legibles por humanos (por ejemplo, region: EMEA es mejor que Param8323 : 1229072).

• Evite incluir varios valores como regions: EMEA | US | LATAM en una sola etiqueta. Recomendamos usar tres etiquetas diferentes para eso, como region: emea, region: us y region: latam. Si desea hacer coincidir varias etiquetas, puede hacerlo usando las opciones avanzadas en la UI del filtro.

  • Una advertencia para el incidente de alerta: estos solo admiten una instancia de nombre de clave. Si utiliza varios nombres clave, se seleccionará uno al azar para agregarlo a ese incidente.

• Intente ser coherente con el lenguaje de las etiquetas en sus equipos y entidad.
• Sea coherente con los nombres. Por ejemplo, evite usar region: emea y reg: emea.
• Sea coherente con el formato. Por ejemplo, evite usar camelCase y kebab-case.
• Aunque la búsqueda de etiquetas no distingue entre mayúsculas y minúsculas en la UI y la API, intente ser coherente con el uso de mayúsculas. Por ejemplo, evite usar env: staging y env: Staging.

La etiqueta ayuda a mejorar la observabilidad y la asignación de costos. Por esta razón, la responsabilidad de la implementación de la etiqueta a menudo se asigna a un equipo de observabilidad, SRE, un grupo de arquitectos o un grupo de trabajo entre equipos.

Recomendamos que las personas responsables de implementar la etiqueta se reúnan y creen una política interna para describir cómo se define la etiqueta y qué convenciones se utilizarán. Entonces:

• Mantenga actualizado este manual de referencia.
• Automatiza la definición de etiqueta cuando implementas el agente New Relic, en el proveedor de la nube, o a través de herramientas de automatización de New Relic, como la API o el proveedor New Relic Terraform.
• Cree informes recurrentes que identifiquen entidades que no cumplen con sus estándares de etiquetas.

Crear etiquetas para los nombres de los equipos puede resultar útil para comprender qué equipo, grupo, departamento o región fue responsable de un cambio que provocó un problema de rendimiento.

### Team tags
team: backend
team: frontend
team: db
### Role tags
roles: architecture
roles: devops
roles: pm
### Region tags
region: emea
region: america
region: asia

Puedes crear entidad para el entorno al que pertenecen. Por ejemplo:

env: production
env: qa
env: development
env: staging

Puede crear etiquetas relacionadas con los niveles de criticidad, lo que le permite rastrear más fácilmente los problemas más críticos. Por ejemplo:

layer: level1
layer: level2
layer: level3

Dado un servicio que se distribuye en nueve fragmentos, cada fragmento asignado como environment, podemos trazar el rendimiento de la transacción en todos los fragmentos utilizando una consulta con comodín como:

SELECT rate(count(apm.service.transaction.duration), 1 minute)
  FROM Metric WHERE appName LIKE 'MyApp (%' AND transactionType = 'Other'
  FACET tags.Environment TIMESERIES

Para ver el número de transacciones por servicio para un equipo específico, podríamos usar una consulta como:

FROM Transaction SELECT count(*)
  WHERE tags.Team = 'team-a'
  FACET tags.Project TIMESERIES

Puede utilizar una consulta de la tasa de errores de sus servicios para configurar una alerta sin tener que crear una regla para cada servicio. Aquí está la tasa de errores para todos los servicios en un equipo llamado team-b. Y esta alerta monitor automáticamente cualquier nombre de aplicación nueva agregado con la etiqueta del equipo.

FROM Metric SELECT count(apm.service.error.count) / count(apm.service.transaction.duration)
  WHERE tags.Team = 'team-b' FACET appName

Relacionado con esto, se podría crear una regla general para que un servicio específico se despliegue en varios entornos, de modo que tengamos una alarma para un solo servicio monitoreando cada entorno individualmente:

From Metric SELECT count(apm.service.error.count) / count(apm.service.transaction.duration)
  WHERE tags.Project = 'MyProject' FACET tags.Environment

Para buscar equipos internos que posean una entidad denominada, por ejemplo, SensitiveEntity, ejecute lo siguiente:

FROM SystemSample SELECT internalOwningTeam WHERE entityName = 'SensitiveEntity'

Supongamos que desea realizar algunas pruebas de carga en su diferente entidad de infraestructura con CPU. Puede aplicar un tratamiento a la entidad en un grupo llamado A, aplicar un tratamiento diferente a la entidad en un grupo llamado B y mantener un grupo de entidades sin tratamientos, llamado control group.

Puede crear una etiqueta llamada experimentGroup en la UI de New Relic, asignada al grupo experimental al que pertenece cada entidad. Dado que estas son etiquetas creadas en la UI de New Relic, debe agregar el prefijo tags. al nombre de la etiqueta, a diferencia del atributo personalizado creado en el archivo de configuración newrelic-infra.yml.

Aquí está la consulta NRQL para seleccionar cpuPercent, desglosada por los diferentes grupos experimentales usando una cláusula FACET CASES (...) :

FROM SystemSample SELECT cpuPercent FACET CASES (WHERE tags.experimentGroup = 'control' AS 'control group', WHERE tags.experimentGroup = 'A' AS 'given treatment A', WHERE tags.experimentGroup = 'B' AS 'given treatment B') SINCE 1 DAY AGO

Para desactivar la propagación de etiquetas para la etiqueta de infraestructura, ejecute lo siguiente en NerdGraph:

mutation {
  dataManagementUpdateFeatureSettings(
    accountId: YOUR_ACCOUNT_ID
    setting: {
      enabled: false
      featureSetting: { key: "infra_tag_propagation" }
      locked: false
    }
  ) {
    enabled
    key
    locked
    name
  }
}

Esa llamada debería devolver la siguiente respuesta:

{
  "data": {
    "dataManagementUpdateFeatureSettings": {
      "enabled": false,
      "key": "infra_tag_propagation",
      "locked": false,
      "name": "Infra tag propagation"
    }
  }
}