Nuestra integración F5 BIG-IP recopila y envía inventario y métrica desde su instancia F5 BIG-IP a nuestra plataforma, donde puede agregar y visualizar el rendimiento métrico clave. Recopilamos datos a nivel de sistema, aplicación, grupo, miembro del grupo, servidor virtual y nodo.
Continúe leyendo para instalar la integración y ver qué datos recopilamos.
Compatibilidad y requisitos
Nuestra integración es compatible con F5 BIG-IP 11.6 o superior.
Antes de instalar la integración, asegúrese de cumplir con los siguientes requisitos:
- Instale el agente de infraestructura.
- Distribución Linux o versión Windows compatible con el agente de infraestructura.
- Cuenta de usuario F5 BIG-IP con privilegios de usuario de acceso a nivel de auditor y permisos de acceso a iControl REST API.
Instalar y activar
Para instalar la integración F5 BIG-IP, elija su configuración:
Notas adicionales:
Le recomendamos instalar la integración en un servidor separado y monitor F5 de forma remota.
Advanced:
También es posible instalar la integración desde un archivo tarball. Esto le brinda control total sobre el proceso de instalación y configuración.
On-host integrations do not automatically update.
Para obtener mejores resultados, actualice periódicamente el paquete de integración y el agente de infraestructura.
Habilite su instancia F5
Cree un nuevo usuario F5 BIG-IP y asigne permisos de usuario:
- Cree una cuenta de usuario con, como mínimo, permisos de acceso a nivel de auditor. Para obtener instrucciones sobre cómo hacer esto, consulte la documentación oficial de F5.
- Una vez creado el usuario, asigne al usuario los permisos de usuario REST de iControl.
Sugerencia
Es posible que se requieran permisos de nivel de administrador para recopilar algunos datos métricos de muestra del sistema o datos de configuración del inventario del sistema . Para obtener más información sobre los niveles de permiso de usuario, consulte la documentación oficial de F5 sobre descripciones de acceso al rol de usuario.
¿Te ha ayudado este documento con la instalación?
Configurar la integración
Hay varias formas de configurar la integración, dependiendo de cómo se instaló:
- Si está habilitado a través de Kubernetes, consulte supervisar los servicios que se ejecutan en Kubernetes.
- Si está habilitado a través de Amazon ECS, consulte monitorear servicios que se ejecutan en ECS.
- Si se instala a través del host, edite la configuración en el archivo de configuración YAML de la integración,
f5-config.yml
.
La configuración de formato YAML de una integración es donde puede colocar las credenciales de inicio de sesión requeridas y configurar cómo se recopilan los datos. Las opciones que cambie dependen de su configuración y preferencia.
El archivo de configuración tiene configuraciones comunes aplicables a todas las integraciones, como interval
, timeout
y inventory_source
, entre otras. Para obtener más información sobre estas configuraciones comunes, consulte nuestro documento de lista de propiedades de configuración .
Si todavía estás usando nuestros archivos de configuración/definición legacy, consulta integración en el formato de configuración estándar del host.
Las configuraciones específicas relacionadas con F5 se definen usando la sección env
del archivo de configuración. Estas configuraciones controlan la conexión a su instancia F5, así como otras configuraciones y características de seguridad.
Sugerencia
Después de la versión 2.6.0, la integración se crea aprovechando golang 1.18.0. El cliente HTTP ya no depende de CommonName para validar el certificado.
El comportamiento heredado y legacy de tratar el campo CommonName en los certificados X.509 como un nombre de host cuando no hay nombres alternativos de sujeto presentes ahora está deshabilitado de forma predeterminada. Para solucionar este problema, el usuario debe actualizar el certificado basándose en
Subject Alternative Name
. Mientras el certificado no esté actualizado, la validación del certificado podría deshabilitarse configurando--tls_insecure_skip_verify
en verdadero.
Configuración de instancia F5
La integración F5 recopila información métrica (M) e inventario (I). En la tabla, utilice la columna Applies To para las configuraciones disponibles para cada colección:
' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' '
Configuración | Descripción | Por defecto | Se aplica a |
---|---|---|---|
HOSTNAME | Nombre de host o IP donde se está ejecutando F5. | host local | M/I |
PORT | Puerto en el que escucha la API de F5. | 443 | M/I |
USERNAME | Nombre de usuario para acceder a la API de F5. | N/A | M/I |
PASSWORD | Contraseña para el usuario dado. | N/A | M/I |
CA_BUNDLE_FILE | Archivo de paquete de autoridad de certificación alternativa. | N/A | M/I |
CA_BUNDLE_DIR | Directorio de paquete de autoridad de certificación alternativa. | N/A | M/I |
TIMEOUT | Tiempo de espera para solicitudes, en segundos. | 30 | M/I |
PARTITION_FILTER | Una matriz JSON de particiones BIG-IP para recopilar. Vea este ejemplo de filtrado solo métrico con partición. | ["Common"] | M |
MAX_CONCURRENT_REQUESTS | Número máximo de solicitudes que se ejecutan simultáneamente. | 10 | M |
TLS_INSECURE_SKIP_VERIFY | Omitir la verificación del certificado enviado por el anfitrión. | false | M/I |
METRICS | Establezca en | false | |
INVENTORY | Configúrelo en | false |
Puede definir estos valores de configuración de diferentes maneras, según sus preferencias y necesidades:
- Agregue el valor directamente en el archivo de configuración. Esta es la forma más común.
- Reemplace los valores de las variables de entorno utilizando la notación
{{}}
. Esto requiere el agente de infraestructura v1.14.0 o superior. Lea más sobre el uso de transferencia o vea el ejemplo de reemplazo de variables de entorno. - Utilice la administración de secretos para proteger información confidencial, como contraseñas, que estaría expuesta en texto sin formato en el archivo de configuración. Para obtener más información, lea más sobre el uso de la gestión de secretos.
Etiquetas/atributo personalizado
También puedes decorar tu métrica usando etiquetas. Las etiquetas le permiten agregar valor par principal atributo a su métrica, que luego puede usar para consultar, filtrar o agrupar su métrica.
Nuestro archivo de configuración de muestra predeterminado incluye ejemplos de etiquetas. Puede eliminar, modificar o agregar nuevos de su elección.
labels: env: production role: load_balancer
Configuración de ejemplo
Buscar y utilizar datos
Para encontrar sus datos de integración, vaya a one.newrelic.com > All capabilities > Infrastructure > Third-party services y seleccione uno de los enlaces de integración de F5 BIG-IP.
Los datos de F5 BIG-IP se adjuntan a los siguientes tipos de eventos:
F5BigIpSystemSample
F5BigIpVirtualServerSample
F5BigIpPoolSample
F5BigIpPoolMemberSample
F5BigIpNodeSample
Para obtener más información sobre cómo encontrar y utilizar sus datos, consulte Comprender los datos de integración.
Datos métricos
La integración F5 BIG-IP recopila el siguiente atributo de datos métricos. Algunos nombres de métricas tienen el prefijo de un indicador de categoría y un punto, como system.
, virtualserver.
o pool.
.
Muestra del sistema métrico
Estos atributos se pueden encontrar consultando los tipos de eventos F5BigIpSystemSample
.
Métrica | Descripción |
---|---|
| Cantidad de tics de CPU que la CPU estuvo inactiva por segundo. Requiere permisos de usuario de nivel de administrador para recopilar. |
| Porcentaje promedio de tiempo que la CPU está inactiva. |
| Porcentaje promedio de tiempo que la CPU maneja solicitudes de interrupción. |
| Porcentaje promedio de tiempo que la CPU está esperando IO. |
| Porcentaje promedio de tiempo que la CPU maneja procesos de buen nivel. |
| Porcentaje promedio de tiempo que la CPU maneja solicitudes de interrupción suave. |
| Porcentaje promedio de tiempo que la CPU maneja ciclos reclamados por el hipervisor. |
| Cantidad de ticks de CPU utilizados por los procesos del kernel por segundo. Requiere permisos de usuario de nivel de administrador para recopilar. |
| Porcentaje promedio de tiempo que el kernel utiliza la CPU. |
| Cantidad de ticks de CPU utilizados por los procesos de usuario por segundo. Requiere permisos de usuario de nivel de administrador para recopilar. |
| Porcentaje promedio de tiempo que los procesos de usuario utilizan la CPU. |
| Cantidad total de memoria libre, en bytes. |
| Cantidad total de memoria, en bytes. Requiere permisos de usuario de nivel de administrador para recopilar. |
| Cantidad total de memoria utilizada, en bytes. Requiere permisos de usuario de nivel de administrador para recopilar. |
| Memoria libre reservada para procesos del plano de control, en bytes. |
| Memoria total reservada para procesos del plano de control, en bytes. |
| Memoria utilizada reservada para procesos del plano de control, en bytes. |
| Intercambia espacio libre, en bytes. |
| Espacio de intercambio total, en bytes. |
| Espacio de intercambio utilizado, en bytes. |
| Memoria libre reservada para Traffic Management Microkernel (TMM), en bytes. |
| Memoria total reservada para Traffic Management Microkernel (TMM), en bytes. |
| Memoria utilizada reservada para Traffic Management Microkernel (TMM), en bytes. |
Ejemplo de servidor virtual métrica
Estos atributos se pueden encontrar consultando el tipo de evento F5BigIpVirtualServerSample
.
Métrica | Descripción |
---|---|
| La disponibilidad definida por BIG-IP. Opciones:
|
| La tasa de conexiones creadas a través del lado cliente del objeto por segundo. |
| Indica si el multiprocesamiento de clúster (CMP) está habilitado o no. |
| Muestra los indicadores del modo Multiprocesamiento (CMP) del clúster. Opciones:
|
| El número actual de conexiones de BIG-IP. |
| Duración máxima de la conexión desde el lado del cliente del objeto. |
| Duración mínima de la conexión desde el lado del cliente del objeto. |
| El estado habilitado actual. Opciones:
|
| Número total de bytes que pasan por el puerto efímero por segundo. |
| Número total de bytes que salen a través del puerto efímero por segundo. |
| La tasa de creación de conexiones a través del puerto efímero por segundo. |
| El número actual de conexiones a través del puerto efímero. |
| El número de conexiones que se desalojan a través del puerto efímero por segundo. |
| Número máximo de conexiones a través del puerto efímero. |
| El número de paquetes que entran a través del puerto efímero por segundo. |
| La cantidad de paquetes que salen a través del puerto efímero por segundo. |
| La cantidad de conexiones lentas que se eliminan a través del puerto efímero por segundo. |
| La tasa de conexiones desalojadas por segundo. |
| La cantidad de datos recibidos del servidor virtual BIG-IP, en bytes. |
| La cantidad de datos enviados al servidor virtual BIG-IP, en bytes. |
| La cantidad de paquetes recibidos del servidor virtual BIG-IP. |
| La cantidad de paquetes enviados al servidor virtual BIG-IP. |
| El número de solicitudes en el último intervalo de recopilación a BIG-IP. |
| La cantidad de conexiones lentas interrumpidas a través del lado cliente del objeto por segundo. |
| Una explicación del estado actual. |
| La proporción de uso del servidor virtual. |
Piscina muestra métrica
Estos atributos se pueden encontrar consultando el tipo de evento F5BigIpPoolSample
.
Métrica | Descripción |
---|---|
| El número de miembros activos del grupo. |
| El estado de disponibilidad actual. Opciones:
|
| El número actual de conexiones. |
| El máximo de decadencia exponencial de la edad de la cola. |
| La media móvil exponencial de la edad de la cola. |
| El jefe de edad de la cola actual. |
| La edad máxima de la cola es la máxima de todos los tiempos. |
| La suma de la edad máxima de la cola de los miembros del grupo en decadencia exponencial. |
| La suma del promedio móvil exponencial de la edad de la cola de los miembros del grupo. |
| La suma de la edad de la cola de los miembros del grupo. |
| La suma de la edad máxima de todos los tiempos de la cola de miembros del grupo. |
| La suma de la profundidad de los miembros del grupo. |
| La profundidad de la cola. |
| Las conexiones actuales. |
| El estado habilitado actual puede ser definido por el usuario. Opciones:
|
| La cantidad de datos recibidos del grupo BIG-IP, en bytes. |
| Grupo mínimo de miembros activos. |
| La cantidad de datos enviados al grupo BIG-IP, en bytes. |
| La cantidad de paquetes recibidos del grupo BIG-IP. |
| La cantidad de paquetes enviados al grupo BIG-IP. |
| El número total de solicitudes al grupo. |
| Propiedad textual que explica el motivo de salud general. |
Muestra de miembro del grupo métrica
Estos atributos se pueden encontrar consultando el tipo de evento F5BigIpPoolMemberSample
.
Métrica | Descripción |
---|---|
| La disponibilidad actual del sistema BIG-IP. Opciones:
|
| Las conexiones actuales. |
| Estado habilitado del miembro del grupo con respecto al grupo principal. Opciones:
|
| La cantidad de datos recibidos del miembro del grupo BIG-IP, en bytes. |
| El estado del monitor. Opciones:
|
| La cantidad de datos enviados al miembro del grupo BIG-IP, en bytes. |
| La cantidad de paquetes recibidos del miembro del grupo BIG-IP. |
| La cantidad de paquetes enviados al miembro del grupo BIG-IP. |
| El número actual de solicitudes durante el último intervalo de recopilación. |
| El recuento de sesiones actual. |
| El estado de salud de la sesión actual. Opciones:
|
| El estado actual. Opciones:
|
| Explicación del estado actual. |
Muestra de nodo métrica
Estos atributos se pueden encontrar consultando el tipo de evento F5BigIpNodeSample
.
Métrica | Descripción |
---|---|
| El estado actual de disponibilidad de BIG-IP para el nodo. Opciones:
|
| El número actual de conexiones de red de BIG-IP. |
| El número de conexiones realizadas por segundo. |
| El estado actual habilitado para BIG-IP. Opciones:
|
| La cantidad de datos recibidos del nodo BIG-IP, en bytes. |
| El estado actual de la regla del monitor de salud. Opciones:
|
| La cantidad de datos enviados al nodo BIG-IP, en bytes. |
| La cantidad de paquetes recibidos del nodo BIG-IP. |
| La cantidad de paquetes enviados al nodo BIG-IP. |
| El número actual de solicitudes durante la última recopilación de BIG-IP. |
| El número actual de sesiones. |
| El estado actual de la sesión. Opciones:
|
| Razón de BIG-IP para el estado actual. |
Datos de inventario
La integración F5 BIG-IP también recopila datos de configuración a nivel de sistema, aplicación, grupo, miembro del grupo, servidor virtual y nodo.
Los datos están disponibles en la página Inventario en la UI de infraestructura, en la fuente config/f5. Para obtener más información sobre los datos de inventario, consulte Comprender los datos de integración.
La integración captura datos para el siguiente parámetro de configuración F5 BIG-IP:
Comprueba el código fuente
Esta integración es software de código abierto. Eso significa que puedes explorar su código fuente y enviar mejoras, o crear tu propia bifurcación y compilarla.