Plugin Grafana
En este tema se incluyen instrucciones para instalar, configurar y utilizar el origen de datos de Oracle Cloud Infrastructure para Grafana.
En este tema se incluyen instrucciones para instalar, configurar y usar el origen de datos de Oracle Cloud Infrastructure para Grafana, también denominado plugin de Grafana.
Visión general del plugin Grafana
Grafana es una herramienta de visualización y alertas de código abierto que puede utilizar para análisis y supervisión de datos de serie de tiempo (métricas). Aunque las métricas de Oracle Cloud Infrastructure Monitoring son visibles en el gráfico de métricas a través de la consola, puede usar el origen de datos de Oracle Cloud Infrastructure para Grafana ("el plugin Grafana") para ver las métricas de los recursos de los proveedores en un único panel de control Grafana.
Requisitos para utilizar el plugin Grafana
- Una cuenta de Oracle Cloud Infrastructure.
- Un usuario de esa cuenta, en un grupo de seguridad con una política de IAM que otorga los permisos necesarios para trabajar con recursos en los compartimentos de la cuenta. La política debe proporcionarle acceso a los espacios del nombre de métrica que emiten métricas (como Compute) así como también a los recursos relacionados (como un juego de instancias informticas). Si intenta realizar una acción y obtiene un mensaje que le indica que no tiene permiso o no está autorizado, confirme con el administrador el tipo de acceso que le han otorgado y en qué compartimento debe trabajar. Administradores: para políticas comunes que proporcionan a los grupos acceso a métricas, consulte Acceso a métricas para grupos. Para autorizar a recursos, como instancias, a realizar llamadas de API, agregue los recursos a un grupo dinámico a través de sus reglas de coincidencia y, a continuación, cree una política que permita el acceso de grupo dinámico a las métricas. Para permitir el acceso entre compartimentos, cree la política en el arrendamiento. Debido al concepto de herencia de políticas, las instancias del grupo dinámico indicado pueden acceder a las métricas de cualquier compartimento. Para reducir el ámbito de acceso a un compartimento concreto, especifique ese compartimento en lugar del arrendamiento. Consulte Acceso a métricas para recursos.
- Instancias de Compute: para emitir métricas, el plugin de supervisión de instancias de Compute debe estar activado en la instancia y estos plugins deben estar ejecutándose. La instancia también debe tener un gateway de servicio o una dirección IP pública para enviar las métricas al servicio Monitoring. Para obtener más información, consulte Activación de la supervisión para instancias informáticas.
- Claves e identificadores de Oracle Cloud Infrastructure (OCID) necesarios. Para obtener instrucciones, consulte Claves y OCID necesarios.
Descarga e instalación del plugin Grafana
Grafana se debe instalar antes de poder instalar el plugin Grafana. Se necesita la versión 3.0 o posterior.
La autenticación para el acceso a métricas depende de dónde se esté ejecutando Grafana. Si está ejecutando Grafana en una máquina local fuera de Oracle Cloud Infrastructure, debe llamar a la API para Monitoring mediante la interfaz de línea de comandos (CLI). Si ejecuta Grafana en una instancia informática de la Oracle Cloud Infrastructure que ha creado, puede agregar la instancia a un grupo dinámico configurando una regla de coincidencia. En todos los escenarios, tiene la opción de llamar a la API con CLI.
Para obtener instrucciones sobre la instalación del plugin Grafana (origen de datos de de Oracle Cloud Infrastructure para Grafana), consulte https://github.com/oracle/oci-grafana-plugin.
Configuración del plugin Grafana
En esta sección se describe cómo agregar el plugin Grafana y configurar un panel de control.
Cuando se instala localmente, el plugin Grafana accede a las métricas utilizando llamadas a la API de Monitoring.
-
Configure la CLI para acceder a la API de Oracle Cloud Infrastructure.
Tendrá que acceder a la API de Monitoring para autenticación.
-
Navegue a la página inicial de Grafana en la siguiente URL.
-
Agregue el plugin Grafana (origen del dato de Oracle Cloud Infrastructure para Grafana).
Además de los pasos siguientes, consulte las instrucciones de Grafana para agregar orígenes de datos en https://grafana.com/docs/grafana/latest/getting-started/getting-started/.
- En Grafana, en el panel de control principal, haga clic en el icono de engranaje situado a la izquierda.
- Haga clic en Agregar origen de datos.
- En el cuadro de texto Filtro, escriba: oracle-oci-datasource
- En la lista filtrada, seleccione oracle-oci-datasource.
-
En la página Configuración, introduzca su OCID de arrendamiento, región por defecto y entorno. Para Entorno, seleccione local.
- Configure un panel de control de tipo "gráfico".
-
(Opcional) Para confirmar el acceso a las métricas desde Oracle Cloud Infrastructure, actualice su consulta del panel de mando ("Métricas") con una región, compartimento, espacio y métrica específicos. También puede agregar una o más dimensiones.
Enhorabuena. Ahora puede ver las métricas de de Oracle Cloud Infrastructure en Grafana.
local es para despliegues de Grafana fuera de Oracle Cloud Infrastructure.
Instancia de OCI es para despliegues de Grafana en recursos Oracle Cloud Infrastructure.
Ahora se agrega el origen de datos, lo que le permite configurar un panel que muestre métricas de Oracle Cloud Infrastructure.
Solución de problemas del plugin
Si la consulta del panel de Control ("Métricas") no se rellena con opciones, o si tiene otras incidencias al acceder a las métricas, puede que la política de IAM utilizada Para acceder a las métricas tenga el formato incorrecto o que no incluya todas las reglas de coincidencia necesarias para su grupo dinámico (para ejecutar Grafana en una instancia informática de de Oracle Cloud Infrastructure que haya creado).
Para resolver este problema, haga lo siguiente:
- Revise la política IAM para asegurarse de que cumple los requisitos.
- Si ha actualizado su política de IAM, reinicie el servidor de Grafana y refresque la página de inicio de Grafana.