Te ofrecemos esta traducción automática para facilitar la lectura.
En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.
Todavía estamos trabajando en esta característica, ¡pero nos encantaría que la probaras!
Esta función se proporciona actualmente como parte de una vista previa de conformidad con nuestras políticas de prelanzamiento.
La capacidad de seguimiento de cambios le permite capturar, visualizar y analizar cambios en su aplicación e infraestructura. Esta función está diseñada para ayudarlo a comprender cómo los cambios afectan tanto a su sistema como a sus clientes.
Capture todos los cambios que impactan su sistema: envíe eventos de cambio para cualquier tipo de cambio, incluidos cambios en los indicadores de características, cambios de configuración y eventos comerciales. También puede crear eventos de cambio personalizados adaptados a sus requisitos específicos. Emplee la mutación NerdGraph changeTrackingCreateEvent para enviar fácilmente varios tipos de eventos de cambio.
Obtenga una vista integral para gestionar cambios en todo el sistema: vea y filtre sin problemas eventos de cambio en todas sus entidades y cuentas desde una interfaz unificada. Identifique los cambios sin esfuerzo filtrando por equipo, tipo, atributo personalizado y cualquier otro criterio.
Correlacione rápidamente los cambios con telemetría para acelerar el descubrimiento de la causa raíz: mejore su comprensión del impacto del cambio visualizando eventos de cambio junto con sus datos de seriales de tiempo. Para encontrar la causa raíz más rápidamente, agregue una consulta de seriales de tiempo para mostrar eventos de cambio con métricas relevantes, lo que permite una correlación clara.
Enriquezca su evento de cambio con metadatos completos: realice un seguimiento de toda la información necesaria sobre sus cambios empleando atributos personalizados, categorías y tipos. Adapte su evento de cambio para incluir todos los detalles necesarios para lograr una claridad total del sistema.
Accede a la página de seguimiento de cambios en New Relic
Puede acceder a la página Change Tracking de las siguientes maneras:
seguimiento de cambios en toda la página de entidad
La página Change Tracking en todas las entidades muestra una vista consolidada de los eventos de cambio para todas las cuentas y entidades en una sola página. Le permite:
Revisar los cambios en todas las cuentas y entidades accesibles.
Filtrar eventos de cambio por cuenta, entidad, tipo de despliegue y otros atributos para refinar los resultados.
Agregue una consulta de seriales de tiempo para visualizar eventos de cambio en relación con datos de seriales de tiempo en varias entidades y cuentas.
Para acceder al seguimiento de cambios en todas las entidades:
Para agregar la página Change Tracking a su navegación izquierda, haga clic en el ícono de pin.
La página Change Tracking en todas las entidades muestra el evento de cambio para todas las entidades y cuentas a las que tiene acceso. Puedes ver estos eventos en los dos componentes:
Tabla de eventos de cambio: esta tabla enumera los eventos de cambio de sus cuentas accesibles. Cada evento de la tabla también está marcado en el gráfico de seriales de tiempo.
Para refinar la lista, emplee la barra de filtro con el atributo evento y la etiqueta entidad.
Ajuste el rango de tiempo mostrado empleando el selector de tiempo o haciendo clic y arrastrando una selección directamente en el gráfico.
Gráfico de seriales de tiempo de eventos de cambio: ejecute una consulta NRQL y vea los resultados en este gráfico con el evento de cambio superpuesto. Esta visualización lo ayuda a correlacionar las tendencias de datos (como picos o caídas) con cambios específicos del sistema en todas sus cuentas.
CONSEJO
El gráfico y la tabla pueden mostrar un máximo de 1000 eventos cada uno. Si sus filtros actuales y el rango de tiempo dan como resultado más de 1000 eventos, solo se mostrarán los 1000 eventos más recientes. Para ver un conjunto más específico de eventos (menos de 1000), aplique un filtro más restrictivo o seleccione un rango de tiempo más corto.
/* <table> <thead> <tr> <th></th> <th></th> </tr> </thead> <tbody> <tr> <td>Tabla de eventos de cambio</td> <td> La tabla de eventos de cambio en la página Change Tracking muestra los cambios para todas sus cuentas accesibles. Cada evento está marcado en el gráfico de seriales de tiempo. Emplee la barra de filtro para refinar la lista por atributo de evento y etiqueta de entidad. Ajuste el rango de tiempo con el selector de tiempo para modificar el número de eventos mostrados.</td> </tr> <tr> <td>Gráfico de seriales de tiempo de eventos de cambio</td> <td>El gráfico de seriales de tiempo le permite ejecutar una consulta <DNT>NRQL</DNT> válida y superponer eventos de cambio en los resultados. Esta función ayuda a correlacionar picos en los datos del gráfico con eventos de cambio en todas las cuentas.</td> </tr> </tbody> </table> */
Vista con alcance de entidad de seguimiento de cambios
La vista Change Tracking con ámbito de entidad muestra eventos de cambio para una entidad específica, como APM, navegador o dispositivo móvil. También ofrece información adicional relacionada con las Señales doradas para cada evento de cambio.
Para acceder a Change Tracking para la vista con alcance de entidad:
Seleccione la entidad requerida y luego haga clic en Change Tracking.
Seguimiento de cambios utilizando NerdGraph
La capacidad de seguimiento de cambios de New Relic le permite monitorear el impacto de varias modificaciones en sus sistemas. Por ejemplo, puede registrar una campaña de marketing como un evento de cambio y luego emplear la UI de seguimiento de cambios para analizar su efecto en el rendimiento del sistema a través de gráficos.
Para registrar la implementación y otros tipos de eventos de cambio, emplee la mutación NerdGraph changeTrackingCreateEvent. Para obtener más información sobre el uso de NerdGraph, consulte Introducción a NerdGraph.
Todos los tipos de usuarios de New Relic pueden usar NerdGraph para crear eventos de cambio, pero solo el usuario de la plataforma completa puede acceder a las experiencias UI de seguimiento de cambios seleccionadas.
seguimiento de cambios evento mutación
Emplee la mutación changeTrackingCreateEvent para crear un evento de cambio proporcionando sus atributos obligatorios y opcionales.
Importante
Los eventos de cambio creados con la mutación changeTrackingCreateEvent no se muestran actualmente en el mosaico de implementación de Resumen APM ni en la función Transacción 360 durante su vista previa pública. Está previsto que estos eventos se realicen en ambos GA.
Atributo
Tipo de datos
Descripción
category
Cadena
Un atributo category le permite categorizar los cambios empleando varios categories y types. Puede emplear nuestras categorías y tipos estándar predefinidos o definir los suyos propios.
Debes establecer el atributo categoryFields en Deployment.
Este campo deployment debe incluir un version.
Si establece category en Feature flag:
Debes establecer el atributo categoryFields en Feature flag.
Este campo featureFlag debe incluir un featureFlagId.
Para emplear categorías personalizadas:
Dentro del atributo dataHandlingRules, establezca el campo validationFlags en ALLOW_CUSTOM_CATEGORY_OR_TYPE.
type
Cadena
El atributo type proporciona una distinción adicional para un evento de cambio, a menudo empleado junto con category. Por ejemplo, si category de un evento es Deployment, su tipo podría ser Rolling.
Puede emplear un estándar predefinido type normalmente asociado con un estándar category o definir un type personalizado. Si define un tipo personalizado, también debe:
Configure el atributo dataHandlingRules.
Establezca el atributo validationFlags en ALLOW_CUSTOM_CATEGORY_OR_TYPE.
version
Cadena
Si el atributo
category
se establece en
Deployment
, entonces, dentro del atributo
categoryFields
, debe definir un campo
deployment
y cerciorar de que este campo
deployment
incluya un
version
.
featureFlagId
Cadena
Si selecciona
Feature flag
como su categoría, bajo el atributo
categoryFields
, también debe seleccionar
featureFlag
e incluir un
featureFlagId
. Este
id
puede ser cualquier cadena con la que desea identificar su bandera de característica.
dataHandlingRules
Cadena
Cuando define un category personalizado, type o una combinación no estándar de category y type, debe configurar el atributo dataHandlingRules. Esta acción está asociada a la configuración del atributo validationFlags en ALLOW_CUSTOM_CATEGORY_OR_TYPE.
Si validationFlags no se establece en ALLOW_CUSTOM_CATEGORY_OR_TYPE al emplear dichos valores personalizados o no estándar, New Relic devolverá un error si un valor category o type no coincide exactamente con un valor estándar predefinido. Por ejemplo, incluso si emplea un category estándar como Deployment, combinarlo con un tipo custom como Rainbow, que no es una combinación estándar de New Relic, requiere que configure validationFlags en ALLOW_CUSTOM_CATEGORY_OR_TYPE y dataHandlingRules.
Sugerencia
Cuando validationFlags se establece en ALLOW_CUSTOM_CATEGORY_OR_TYPE, cerciorar de que los valores de cadena que proporcione para su atributo personalizado category o type usen exactamente las mismas mayúsculas y minúsculas que desea ver en la New Relic UI.
entitySearchquery
Cadena
El atributo de búsqueda de entidad te permite encontrar una entidad específica dentro de New Relic. Puede buscar empleando su entidad específica GUID o proporcionando otra información de identificación si no conoce el entityGuid. Un entityGuid es un identificador único que New Relic asigna a los componentes de su sistema, como aplicaciones o microservicios, durante su instrumentación o configuración. Para obtener más información sobre la entidad, consulte EntidadNew Relic .
consulta de entidad específica: puede buscar una coincidencia exacta o difusa en varios atributos, incluidos id y name, pero su consulta debe ser lo suficientemente específica para resolver en exactamente una entidad.
Operadores admitidos: =, AND, IN y LIKE son operadores admitidos para la consulta de búsqueda de entidades.
Uso de caracteres especiales: Los caracteres especiales como (, ., ,, ;, :, *,-, _ y ) se tratan como espacios en blanco en la cadena de consulta. Por ejemplo, una consulta como name LIKE ':aws:' coincidirá con nombres de entidades que contengan -aws o foo.aws.
etiqueta: Puedes hacer referencia a etiqueta con o sin comillas invertidas. Puede filtrar la entidad según la entidad predeterminada properties y tags.
entidad predeterminada properties:
id
accountId
name
domainId
alertSeverity
reporting
indexedAt
firstIndexedAt
lastReportingChangeAt
Tags: Las etiquetas son metadatos normalmente vinculados a un domainType o grupo de domainTypes más específico. Por ejemplo:
language: Especifica el idioma del agente para la aplicación APM
clusterAgentId: Para la aplicación Browser, esta etiqueta enlaza con el agente del clúster de la aplicación APM asociada.
aws.accountId: El AWS account ID de infraestructura entidad monitoreado desde AWS.
Ejemplos:
Para encontrar una entidad por su GUID: "id = '<entity guid>'"
Para encontrar una entidad empleando su API REST v2 ID de la aplicación: "domainId = '<app id>' AND domain = 'APM'"
Para encontrar un servicio OpenTelemetry: "name = '<service name>' AND domain = 'EXT' AND type = 'SERVICE' AND accountId = '<account id>'"
Puede definir algún atributo opcional y útil para agregar contexto al cambio que está rastreando. Estos atributos también pueden habilitar ciertas características de seguimiento de cambios.
Parámetros
Tipo de datos
Descripción
description
Cadena
Una descripción del evento de seguimiento de cambios. Por ejemplo:
A change event to track the marketing campaign impact.
groupId
Cadena
Un atributo groupId le permite organizar los cambios relacionados en una o más entidades. Al emplear el mismo groupId para cada cambio relacionado, puede ver fácilmente estos cambios juntos en las interfaces de New Relic o refinar los resultados de la consulta. También puede emplear el mismo groupId para agregar cambios a un grupo existente.
CONSEJO
New Relic recomienda emplear el atributo groupId al realizar múltiples actualizaciones a una o más entidades o implementar varios cambios en su sistema.
shortDescription
Cadena
Una breve descripción de cada cambio le permitirá identificar rápidamente el evento de cambio enviado a New Relic. Si se deja en blanco, se crea una descripción generada automáticamente que incluye la entidad, el usuario y la versión. La breve descripción aparece en las siguientes áreas:
En la bandera del marcador, como información sobre herramientas, cuando pasa el cursor sobre un marcador de cambio en el gráfico.
En los paneles Activity stream.
user
Cadena
Identificación de usuario o una dirección de email válida. Por ejemplo, usuario:
datanerd@example.com
.
changelog
Cadena
Si
category
se establece en
Deployment
, entonces puede incluir opcionalmente información de
changelog
.
commit
Cadena
Si
category
se establece en
Deployment
, entonces puede incluir opcionalmente información
commit
, como por ejemplo
commit SHA
.
deepLink
Cadena
Si
category
se establece en
Deployment
, entonces puedes incluir opcionalmente
deepLink
, como una URL.
New Relic establece automáticamente los atributos timestamp y changeTrackingId. Puede modificar el valor timestamp. Sin embargo, el changeTrackingId debe ser único y siempre lo genera New Relic.
Parámetros
Tipo de datos
Descripción
timestamp
EpochMilliseconds
El atributo timestamp muestra cuándo se recibió una llamada NerdGraph. Puede modificarlo especificando el número de milisegundos desde la época de Unix. Por ejemplo: timestamp: 1032480000000.
Importante
La marca de tiempo debe aplicar dentro de +/- 24 horas de la hora actual cuando se realiza la llamada a NerdGraph, o la carga será rechazada.
changeTrackingId
Cadena
El changeTrackingId es un identificador único que se genera cuando se registra un cambio. Puede emplear esta ID en NerdGraph y NRQL consulta para identificar cambios específicos. Por ejemplo: changeTrackingId: "8a3a594c-e726-4bc2-8078-26dffec9a3d8".
Puede definir su atributo personalizado como pares de valores principales para agregar metadatos adicionales para cambiar el evento.
Parámetros
Tipo de datos
Descripción
customAttributes
Objeto
Un campo customAttributes se especifica como pares key-value en formato de objeto JavaScript, donde los valores pueden ser de tipo string, boolean o number. Los números de JavaScript se almacenan como valores Java long o double. A diferencia de .JSON, las claves en los objetos JavaScript no están entre comillas. Para agregar un atributo personalizado, estructúrelo de la siguiente manera:
customAttributes: {key_name : "value_name"}
Para evitar conflictos de nombres con los nombres de atributos predeterminados y las palabras clave NRQL, se restringen los siguientes nombres de atributos personalizados:
accountId
ago
and
appID
as
auto
begin
begintime
category
categoryType
changeTrackingId
compare
customAttributes
customType
day
days
description
end
endtime
entity.domain
entity.guid
entity.name
entity.type
entityGuid
entityName
explain
eventType
facet
from
fb.input
groupId
hostname
hour
hours
in
is
like
limit
log
minute
minutes
month
months
not
null
offset
or
plugin.type
raw
second
seconds
select
since
timeseries
timestamp
type
until
user
week
weeks
where
with
Mutaciones de muestra
Los siguientes ejemplos muestran mutaciones de NerdGraph, con sus atributos obligatorios y opcionales, para crear marcadores de seguimiento:
La página de Detalles proporciona una funcionalidad similar para cambios que no son de despliegue como para cambios de tipo despliegue. Para obtener más información, consulte Ver y analizar sus cambios.
consulta cambio evento usando NRQL
Puede consultar eventos de cambio empleando NRQL y NerdGraph para analizar y visualizar cambios. A continuación se muestran algunos ejemplos de consultas que puedes emplear:
Objetivo
NRQL/NerdGraph
Consultar
Para obtener el cambio del evento de la semana pasada
NRQL
SELECT*FROM ChangeTrackingEvent SINCE 1 week ago
Para comparar errores de transacción con marcadores de cambio de una aplicación durante el último mes
NRQL
SELECTcount(*)
FROM TransactionError
WHERE appName ='INSERT_YOUR_APP_NAME'AND http.statusCode >300
SINCE 1month ago TIMESERIES
Para enumerar un conjunto de eventos en todas las cuentas durante la última hora