• EnglishEspañol日本語한국어Português
  • Inicia sesiónComenzar ahora

Te ofrecemos esta traducción automática para facilitar la lectura.

In the event of any inconsistency between the English version and the translated version, the English versionwill take priority. Please visit this page for more information.

Crea una propuesta

Variables de plantilla: filtrar dinámicamente el panel

Para personalizar el panel, puede utilizar template variables para filtrar dinámicamente gráficos y otros widgets. Las variables de plantilla ayudan a que su panel sea más útil y le ayudan a crear más fácilmente un panel que puede reutilizar para diferentes casos de uso.

¿Por qué utilizar variables de plantilla?

Las variables de plantilla son una forma potente y dinámica de filtrar un dashboard completo en función de valores de metadatos específicos que elija el creador dashboard . Los beneficios de utilizar variables de plantilla son:

  • Hacen que el panel sea más fácil de usar: su usuario no tiene que comprender la estructura de los datos, sino que simplemente puede elegir entre varias opciones de filtro que haya configurado.
  • Le permiten crear plantillas dashboard reutilizables, que luego puede duplicar y ajustar para muchos otros usos.

A continuación se muestra un ejemplo de un dashboard con varias variables de plantilla, que puede ver en la parte superior del dashboard.

Con las variables de plantilla, puede configurar una amplia variedad de variables y filtros para crear la experiencia dashboard que necesita. Ejemplos de experiencias que puedes crear:

  • Un menú desplegable para elegir el nombre de una aplicación
  • Un menú desplegable para elegir regiones específicas
  • Un menú desplegable para seleccionar duraciones específicas u otros valores numéricos
  • Filtros que utilizan campos de texto libre para encontrar cadenas coincidentes

Requisitos y limitaciones

Las variables de plantilla solo se pueden utilizar en el contexto de personalizar el widget para el panel de control. Consulte Variables NRQL para utilizar variables en una consulta NRQL.

La consulta con variables de plantilla solo se puede utilizar en el contexto de un dashboard. Por este motivo, algunas características relacionadas con la consulta no funcionan. Por ejemplo, la opción Export dashboard as PDF no admite widgets con variables.

Puntos importantes a tener en cuenta al agregar una consulta:

  • La variable que definiste va dentro de los corchetes {{ … }} .

  • La variable genera un valor de cadena.

  • Para ayudarte cuando estás creando una consulta, hay un código de color:

    • Las cláusulas from, select, facet y where están en rosa.
    • Identificador están en negro.
    • Las funciones están en azul.
    • Las cadenas están en verde.
    • Los números enteros están en marrón.
  • Consulte nuestra página Cómo utilizar NRQL: la mecánica de las consultas si desea obtener más información sobre cómo redactar consultas con NRQL.

Para conocer las restricciones relacionadas con la consulta de redacción, consulte Consulta de redacción.

Usar variables de plantilla

Lo guiaremos en la creación de una variable de plantilla y luego le daremos algunos ejemplos de diferentes tipos de variables de plantilla.

La creación de una variable de plantilla consta de dos pasos.

Cuando haya terminado de definir una variable de plantilla y agregar un widget que haga referencia a esa variable, puede verificar que esté funcionando como se esperaba eligiendo diferentes opciones en la barra de variables de plantilla y viendo si el widget cambia según su selección.

A continuación se muestra un ejemplo del widget resultante, a la derecha, con el menú desplegable country a la izquierda.

Reglas para escribir una variable de plantilla de tipo consulta

Como se analizó en la sección sobre la definición de variables de plantilla, existen tres tipos de variables: consulta, lista y campo de texto. La variable de tipo consulta es la más compleja de crear porque debe crear una consulta funcional que devuelva una lista de valores, que luego se emplean para completar el desplegable en la barra de variables de plantilla en la parte superior del dashboard.

Importante

Tenga en cuenta que este es un tema diferente a la redacción de consultas que utilizan una variable de plantilla.

Puede emplear casi cualquier consulta NRQL siempre que devuelva una lista de valores. Para eso, puede emplear las funciones uniques o keyset .

Con uniques:

From PageAction select uniques(countryCode)
-- you can use the second param to define the maximum number of results to be listed.
From PageAction select uniques(countryCode, 10000) --> this will return up to 10k results

Con keyset:

-- with `keyset`, you'll get a list with all of the attributes from the table you're querying from
From PageAction select keyset() SINCE 1 day ago

Tenga en cuenta que no se admiten variables anidadas ya que no puede haber variables dentro de variables.

Algunos ejemplos

A continuación se muestran algunos tipos diferentes de implementaciones de variables de plantilla.

Si aún no lo ha hecho, cree su cuenta New Relic gratuita a continuación para comenzar a monitorear sus datos hoy.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.