Habilitación de la supervisión de métricas

Para recibir métricas de supervisión, debe configurar la instancia de IBM Cloud Monitoring.

Para recibir métricas de supervisión, efectúe los pasos siguientes:

1. Vaya al portal de monitorización de métricas y haga clic en Crear una instancia de monitorización.

2. Seleccione una región para su instancia de IBM Cloud Monitoring.

   Si no tiene ningún servidor VPN existente, consulte Creación de un servidor VPN para suministrar uno.

   La región debe coincidir con la ubicación del servidor VPN existente.

3. Elija su plan de precios. Los detalles del plan de precios se explican en la ventana de selección. Seleccione el plan que mejor se ajuste a sus requisitos.

4. Proporcione un nombre de servicio exclusivo para la instancia. El nombre puede ser el que prefiera el usuario, no tiene ninguna repercusión sobre la funcionalidad.

   No dé a varias instancias de IBM Cloud Monitoring el mismo nombre.

5. Opcionalmente, seleccione un grupo de recursos. Un grupo de recursos organiza los recursos de cuenta en agrupaciones personalizables. Cualquier recurso de la cuenta que se gestione utilizando el control de acceso IBM Cloud® Identity and Access Management (IAM) pertenece a un grupo de recursos dentro de su cuenta.

   Si no tiene ningún grupo de recursos preconfigurado o no tiene ningún motivo para compartir este recurso de forma selectiva, utilice la selección predeterminada.

   Si la cuenta tiene varios grupos de recursos, puede elegir qué grupo tiene acceso a esta instancia de IBM Cloud Monitoring. Al utilizar este acceso selectivo, las métricas pueden estar disponibles para algunos grupos de recursos y no para otros.

6. Marque el recuadro de selección Habilitar métricas de la plataforma. Debe seleccionar esta opción para recibir métricas del servidor VPN.

7. Pulse Crear. Volverá a la página de inicio de Métricas de supervisión.

Al cabo de unos minutos, se visualizará la nueva instancia de IBM Cloud Monitoring con varias configuraciones. Puede que tenga que renovar el navegador para verla.

Cómo trabajar con IBM Cloud Monitoring utilizando las API

También puede trabajar con la instancia de IBM Cloud Monitoring utilizando las API de consulta de métricas. Es posible que desee utilizar API si necesita puntos de datos en bruto o si desea consumir las métricas desde una interfaz de línea de mandatos en lugar de utilizar el panel de control de IBM Cloud Monitoring.

Después de crear la instancia de IBM Cloud Monitoring, debe recopilar las dos informaciones siguientes.

• La señal de la API de supervisión
• El punto final de la instancia de IBM Cloud Monitoring

Para recopilar esta información y trabajar con la instancia de IBM Cloud Monitoring utilizando la API de consulta de métricas, siga estos pasos:

1. Acceda a la página de inicio de supervisión.

2. Pulse Abrir panel de control junto a la instancia con la que desea trabajar.

3. Cuando vea el panel de control de IBM Cloud Monitoring, seleccione el icono del Perfil de cuenta en la barra lateral y, a continuación, seleccione Valores. Ahora verá los valores de la cuenta.

4. La señal de la API de supervisión es una serie alfanumérica que se encuentra en el campo Señal de la API de supervisión de Sysdig. Pulse el botón Copiar para copiar la señal en el portapapeles.

   No comparta esta señal de API. Cualquiera que tenga esta señal de API tendrá acceso completo a sus métricas.

5. El punto final de la instancia de IBM Cloud Monitoring es por región. Por ejemplo, si la instancia de IBM Cloud Monitoring existe en us-south, su punto final es:

   https://us-south.monitoring.cloud.ibm.com/api/data/batch
   

   La primera parte del URL (en este ejemplo, us-south.monitoring.cloud.ibm.com) es su punto final. Anote este URL.

6. Cuando ya tenga la señal de API y el punto final, ya puede formatear la solicitud de POST. A continuación se muestra un ejemplo de solicitud de POST, con todos los parámetros que puede modificar. Los elementos siguientes son parámetros:

   • La señal de la API de supervisión.
   • El punto final de la instancia de IBM Cloud Monitoring.
   • Valor de ibm_is_vpn_server_name (el nombre del servidor VPN cuyas métricas quiere ver el usuario).

   Si quiere ver esta métrica para todos los servidores VPN, no especifique un valor para el atributo scope (ámbito). Por ejemplo, utilice "scope" : "".

   • El tipo de métrica para el que desea ver los resultados. En este ejemplo, se utiliza ibm_is_vpn_server_health_status.
   • Los atributos from y to definen los periodos de tiempo en los que se debe centrar la exploración, definidos en tiempo epoch y en microsegundos.
   • Los atributos sampling y value definen la granularidad de los datos que se devuelven en la solicitud POST.

Puesto que un gran volumen de datos se almacena en IBM Cloud Monitoring, la selección del nivel concreto de granularidad es importante. IBM Cloud Monitoring solo puede devolver 600 puntos de datos a la vez por petición. En consecuencia, los atributos sampling y value son importantes. Si estas dos líneas se dejan fuera de la solicitud, se devuelve una suma agregada de los valores a lo largo de ese periodo de tiempo.

Si el rango de tiempo que se especifica en from y to es grande (por ejemplo, 4 días), pero define 10 segundos de sampling y value, significa que recibirá 4 días de datos divididos fragmentos de 10 segundos. Este ejemplo no es útil debido a la gran cantidad de datos que se devuelven. Se recomienda especificar un fragmento más grande (por ejemplo, 1 hora en lugar de 10 segundos).

   curl \
   -H 'Authorization: Bearer <API_TOKEN>’ \
   -H 'Content-Type: application/json' \
   https://us-south.monitoring.cloud.ibm.com/api/data/batch  \
   -d '{
     "requests": [
         {
             "format": {
                 "type": "data"
             },
             "scope": "ibm_is_vpn_server_name = \"test-001\"",
             "metrics": {
                 "k0": "timestamp",
                 "v1": "ibm_is_vpn_server_health_status"
             },
             "time": {
                 "from": 1624849800000000,
                 "to": 1624850400000000,
                 "sampling": 60000000
             },
             "group": {
                 "by": [
                     {
                        "metric": "k0",
                         "value" : 60000000
                     }
                 ],
                 "aggregations": {
                     "v1": "avg"
                 },
                 "groupAggregations": {
                     "v1": "avg"
                 }
             }
         }
     ]
 }'