Utilización del plugin Grafana para visualizar datos RUM

1. Descargue la última versión del plugin desde https://github.com/ns1/grafana-pulsar-datasource-v2.
2. Descomprima el archivo y mueva el directorio extraído al directorio de plugins especificado en el archivo de configuración de Grafana .
3. Edite su archivo local grafana.ini y realice los siguientes cambios:

   [plugins]
   allow_loading_unsigned_plugins = ns1labs-pulsarmetrics-datasource
   [plugin.ns1labs-pulsarmetrics-datasource]
   allow_local_mode = true

4. Reinicie su instancia Grafana .

1. En el portal Grafana , vaya a la página Configuración desde el menú de la barra lateral y, a continuación, seleccione Plugins para ver una lista de los plugins disponibles.
   
   
2. Compruebe que NS1 Pulsar Metrics está incluido en su lista de plugins instalados. Si no lo ves, consulta los registros de Grafana y busca cualquier mensaje de error relevante.
   Nota: Es posible que aparezca una advertencia temporal sin firmar mientras el plugin está en la cola de revisión de Grafana Labs.
3. Vaya a la pestaña Fuentes de datos (Configuración > Fuentes de datos ) y haga clic en Añadir fuente de datos.
4. Busque y seleccione la fuente de datos NS1 Pulsar Metrics (listada en Otros ).
   
   

   Un mensaje de confirmación indica que el origen de datos se ha añadido correctamente y, a continuación, se le redirige a la página de configuración del complemento.

   
   
   
5. Junto a Clave API, introduzca la clave API NS1 Connect que creó anteriormente. La clave API se almacena de forma segura en la base de datos Grafana . Una vez completado, haga clic en Guardar y probar. Grafana valida que la clave API puede utilizarse para extraer datos de NS1 Connect. Si se realiza correctamente, aparecerá un mensaje de confirmación.
   Nota: Si Grafana devuelve un mensaje de error, compruebe el secreto de la clave API de NS1 Connect o verifique los permisos de la clave API para asegurarse de que son correctos.
   
   
   

   Haga clic en Atrás para volver a las fuentes de datos configuradas. La fuente de datos NS1 Connect Pulsar aparece en la lista.

   
   
   

   Si ésta es la única fuente de datos que tiene instalada, aparece etiquetada como predeterminada. A medida que configures plugins adicionales, puedes especificar uno como predeterminado.

A continuación, cree un nuevo panel en Grafana para consultar los datos de Pulsar .

1. Cree un nuevo cuadro de mandos en Grafana o acceda a uno ya existente.
2. Haga clic en el icono Añadir panel en la esquina superior derecha.
   
   

   Las nuevas opciones aparecen encima del panel de control.

   
   
   
3. Haga clic en Añadir un nuevo panel.
   
   

   La captura de pantalla anterior muestra una consulta de ejemplo con datos de la fuente de datos predeterminada de Grafana. Su vista puede ser diferente dependiendo de su configuración.

   Haga clic en el menú desplegable Fuente de datos (en la parte inferior izquierda, bajo la pestaña Consulta ) y seleccione NS1 Pulsar Métricas. Ahora, todas las aplicaciones y puestos de trabajo disponibles en Pulsar están disponibles para su selección. Tenga en cuenta que sólo puede ver las aplicaciones y trabajos accesibles para la clave API NS1 Connect que introdujo al configurar la fuente de datos.

   Nota: Consulte Creación de aplicaciones y trabajos Pulsar RUM para obtener más información sobre Pulsar aplicaciones y trabajos.
4. En App, seleccione una aplicación Pulsar . Una aplicación Pulsar es una colección de recursos Pulsar .
5. En Trabajo, seleccione un trabajo de Pulsar . Un trabajo corresponde a un único recurso Pulsar (por ejemplo, CDN, centro de datos, nube, etc.) que se está midiendo. El recurso aloja un activo (como una imagen de un solo píxel) para medir la disponibilidad y la latencia cuando la etiqueta JavaScript se ejecuta al cargar la página.
6. En Métrico, seleccione un tipo métrico (es decir, rendimiento o disponibilidad) de la lista.
7. En Agregación, seleccione una de las agregaciones precalculadas (mín., máx., media, p50, p75, , p90, , , p95, ) p99 ).
8. Opcionalmente, puede seleccionar una ubicación geográfica y/o un ASN para filtrar los datos, aunque se recomienda proporcionar al menos una ubicación geográfica para evitar que un gráfico muestre el comportamiento global de la CDN, lo que solo tendrá sentido en determinadas circunstancias.
9. En la barra lateral derecha, introduzca un título para el nuevo panel y ajuste la configuración y las preferencias del panel como desee. Probablemente querrá establecer las unidades del eje Y en milisegundos.
10. Opcionalmente, puede especificar consultas adicionales para comparar el rendimiento o los datos de disponibilidad de varias aplicaciones y trabajos de Pulsar . Vea más abajo para más detalles.
11. Cuando esté listo, haga clic en Aplicar para guardar los cambios. Haga clic en Guardar en la esquina superior derecha cuando haya terminado. Saldrá del modo de edición.
12. Introduzca un nombre para el panel de control (por ejemplo, NS1 Pulsar ) y, a continuación, haga clic en Guardar.

Aparece el nuevo panel de control con el panel que acaba de crear. Puede modificar el panel de control y añadir más paneles según desee.