Los perfiles de los dispositivos definen qué métricas recopilar y cómo transformarlas en métricas de Datadog. Se espera que cada perfil monitorice una clase de dispositivos similares del mismo proveedor.
La plantilla SNMP Profile Manager proporciona una experiencia guiada basada en GUI para:
Crear y gestionar perfiles de dispositivos sin problemas.
Especificar las etiquetas y métricas que se recopilarán de tus dispositivos de red.
Verificar los dispositivos coincidentes con cada perfil.
Revisa un snapshot de los perfiles de dispositivo que creaste en la página de inventario.
Haz clic en SNMP Profile Manager > + Create New Profile (SNMP Profile Manager > Crear nuevo perfil). Esto te lleva a la página de creación del perfil que se muestra a continuación.
Proporciona un nombre y una descripción a tu perfil de dispositivo (opcional).
Selecciona SysObjectID. Este parámetro ajusta los dispositivos de red a los perfiles de dispositivo.
Paso 2: Herencia de perfiles
Utiliza la herencia de perfiles para adoptar configuraciones como metadatos, métricas y etiquetas. Esto simplifica el escalado de tus perfiles de dispositivos y te permite basarte en los ya existentes. Datadog incluye automáticamente algunos perfiles heredados, (_base.yaml_generic-if.yaml , _generic-ip.yaml, _generic-ospf.yaml, _generic-tcp.yaml y _generic-udp.yaml), que se recomienda no eliminar.
Mantén el perfil de Datadog _base.yaml y cualquier otro perfil heredado de Datadog específico para tus necesidades. Opcionalmente, puedes seleccionar perfiles adicionales para heredar. Los campos correspondientes aparecen a la derecha en Perfiles heredados, con una etiqueta Inherited junto a cualquier métrica, etiqueta o metadato heredado:
Nota: Los cambios realizados en el perfil principal se aplican automáticamente a los perfiles secundarios. Si necesitas ajustar algún atributo heredado en los perfiles secundarios, como métricas, etiquetas o metadatos, deberás modificar el perfil principal.
Paso 3: Seleccionar dispositivos de referencia
Utiliza los dispositivos de referencia para seleccionar qué dispositivos deseas recopilar Una dirección o ID únicos en un dispositivo que devuelve el código de respuesta de ese valor cuando se lo consulta. para los modelos de dispositivo elegidos. El campo reference devices (dispositivos de referencia) se preselecciona en función del SysObjectID especificado en detalles del perfil.
Mantén la selección actual de dispositivos de referencia para realizar un escaneo de dispositivos. Además, puedes añadir más dispositivos o cambiar la selección actual.
Haz clic en Scan Devices (Escanear dispositivos) para proceder al paso 4, que inicia el escaneo.
Opcionalmente, haz clic en Proceed Manually (Proceder manualmente) para proceder sin realizar un escaneo.
Paso 4: Escanear dispositivos de referencia
Este paso escanea tus dispositivos para descubrir sus métricas disponibles. Ejecutar un escaneo te permite ver todas las métricas disponibles para tu dispositivo, haciendo más fácil rellenar métricas, metadatos y etiquetas. El escaneo realiza un recorrido de SNMP en tus dispositivos usando la Configuración remota de Datadog.
La pestaña Scanned Devices (Dispositivos escaneados) muestra qué dispositivos se escanearon con la Configuración remota o manualmente.
Paso 5: Definir metadatos
Datadog proporciona valores predeterminados razonables para la mayoría de los dispositivos a través de perfiles predefinidos (OOTB), como el dispositivo y la descripción. Puedes anular estos valores predeterminados en la sección Define Metadata (Definir metadatos).
Haz clic en el icono del lápiz para editar y modificar cualquiera de los campos de metadatos predeterminados.
La funcionalidad de metadatos está disponible y se muestra en la página de Network Device Monitoring (NDM) como facetas de búsqueda y en el panel lateral de un dispositivo seleccionado:
Paso 6: Definir métricas
Las métricas pueden añadirse a partir de un escaneo del dispositivo o creando manualmente una nueva métrica para el perfil. Las métricas heredadas se resaltan en morado con la etiqueta Inherited.
Para definir una métrica utilizando la opción Device Scan (Escaneo de dispositivo), haz clic en Add Metrics (Añadir métrica). Se abrirá un modal con todas las métricas disponibles para el dispositivo.
Pasa el ratón por encima de las métricas para ver las unidades y las descripciones para facilitar la selección.
Selecciona las métricas que deseas añadir y haz clic en Add Metric (Añadir métrica).
Volverás a la pantalla de definición de métricas, donde podrás ver la nueva métrica añadida.
Para definir una métrica utilizando la opción Manual, haz clic en Add Metrics (Añadir métricas). Se abrirá un modal con todas las métricas disponibles para el dispositivo.
Haz clic en Create New Metric (Crear nueva métrica) en la parte superior del modal.
Especifica el OID (escalar o tabular).
Haz clic en el desplegable del campo de búsqueda para añadir el nombre del OID. La barra de búsqueda ofrece una función de autocompletar que sugiere OIDs que coinciden con el valor buscado, o puedes introducir manualmente el nombre o el OID.
La adición de etiquetas a las métricas tabulares es similar a la adición de etiquetas globales, con dos opciones adicionales:
Selecciona si el valor de etiqueta tiene su origen en un valor OID o en un segmento del índice de la tabla. Si se elige Index como origen, debe especificarse una posición de índice, que luego se convierte en la etiqueta.
Example of using an Index position
Consider a table at OID 1.2.3.1.1 with two indices. Each row in this table includes a two-number index. Suppose column 3 of a row has OID 1.2.3.1.1.3.55.12 - here, 1.2.3.1.1 represents the table, .3 is the column number within the table, and .55.12 is the index of this specific row (all other columns for this row will also end with .55.12). If you establish a tag with the Source set to Index and Index Position set to 1, the tag’s value for metrics from this table row will be 55; if you set the index position to 2, it will be 12. If you use an index less than 1 or more than the number of indices in the table, the tag will not be populated.
Utiliza la transformación de índices cuando necesites etiquetar un valor de métrica de la tabla con un valor de una tabla diferente que emplee un subconjunto de índices de esta tabla. Esto no es un escenario típico. Se configura añadiendo uno o varios segmentos de transformación, cada uno con un número inicial y final. Estos números se indexan en el índice de la tabla original para crear un nuevo valor de índice para la nueva tabla.
Example of using Index Transformation
Consider the CPI-UNITY-MIB module. It has a table, cpiPduTable, with details about a specific PDU, and another table, cpiPduBranchTable, with information about specific PDU branches. The index of the main table is the PDU’s MAC address, such as 6.0.36.155.53.3.246. The branch table’s index is a branch ID followed by the PDU MAC, therefore a branch table row index might be 1.6.0.36.155.53.3.246.
If you want to report the current on a PDU branch, you could add cpiPduBranchCurrent (OID 1.3.6.1.4.1.30932.1.10.1.3.110.1.3, from the branch table) as a tabular metric. To tag this metric with the PDU name, add cpiPduName as a tag (OID 1.3.6.1.4.1.30932.1.10.1.2.10.1.3, from the main table), then add an index transform with start:1 and end:7. This means the branch current metric from the branch table indexed with 1.6.0.36.155.53.3.246 would be tagged using the name from the main table indexed with 6.0.36.155.53.3.246.
Añade etiquetas globales para garantizar que los metadatos, las métricas y las etiquetas globales se aplican a todos los dispositivos coincidentes. Las etiquetas globales pueden añadirse a partir de un escaneo de dispositivos o creando manualmente una nueva etiqueta para el perfil. Además, la etiqueta Inherited aparece junto a cualquier etiqueta global heredada de este perfil.
Para definir una etiqueta global utilizando la opción Device Scan (Escaneo de dispositivo), haz clic en + Add Tags (+ Añadir etiquetas). Se abre un modal que muestra todas las etiquetas disponibles para el dispositivo.
Selecciona una o varias etiquetas que desees añadir al perfil del dispositivo y, a continuación, haz clic en Add Tag (Añadir etiqueta).
Volverás a la pantalla de definición de etiquetas globales, donde podrás ver y editar la nueva etiqueta añadida.
Para definir una etiqueta global utilizando la opción Manual, haz clic en + Add Tags (+ Añadir etiquetas). Se abre un modal que muestra todas las etiquetas disponibles para el dispositivo.
Haz clic en Create New Tag (Crear nueva etiqueta) en la parte superior del modal.
Selecciona el desplegable del campo de búsqueda para añadir el nombre del OID.
Haz clic en el desplegable Modification (Modificación) para añadir una modificación. Consulta opciones avanzadas.
Haz clic en Create (Crear) para guardar la nueva etiqueta.
Volverás a la pantalla de definición de etiquetas globales, donde podrás ver la nueva etiqueta añadida.
Opciones avanzadas
Etiquetas globales:
Modificación
Descripción
Sin modificación
El valor devuelto por el dispositivo se utiliza directamente como valor de la etiqueta.
Después de aplicar las opciones de configuración al perfil del dispositivo, haz clic en Save and Sync Agents (Guardar y sincronizar Agents) para aplicar automáticamente este perfil a todos los agents de NDM. Las configuraciones se aplican a tus dispositivos con Configuración remota. Consulta requisitos previos para obtener más información.
Después de guardar un perfil como borrador, vuelve a la página de inicio del perfil y selecciona la opción Download All Profiles (Descargar todos los perfiles). Esto te permite descargar el paquete .zip que contiene los archivos yaml para los perfiles que has creado.
Coloca los archivos yaml en el directorio de perfiles en cada uno de los Agents correspondientes instalados.
Reinicia el Datadog Agent.
Para asegurarte de que los perfiles que creaste son correctos, confirma que NDM está recibiendo métricas de los dispositivos emparejados según lo esperado.
Esta página incluye las siguientes características:
Estado de borrador: indica un perfil nuevo neto que aún no se ha aplicado al Agent. Para aplicar un perfil al Agent, haz clic en el perfil y sincroniza el Agent.
Una vez aplicado un perfil, no puedes volver a ponerlo en estado de borrador.
Filtros: los filtros incluyen las siguientes opciones:
Perfiles personalizados: perfiles de dispositivo creados por el usuario.
Creado por Datadog: perfiles predefinidos de Datadog que se pueden ver y utilizar para crear tu propio perfil personalizado.
Perfiles de borrador: perfiles de dispositivos en modo borrador.
Crear nuevo perfil y descargar: el botón + Create New Profile (+ Crear nuevo perfil) abre el formulario de creación de perfiles que te permite crear un nuevo perfil de dispositivo. Al hacer clic en el botón de descarga se genera y descarga un paquete .zip que contiene los archivos yaml para los perfiles que has creado.
Menú kebab: al hacer clic en el menú kebab situado a la derecha de un perfil, puedes editar, clonar o eliminar el perfil (solo para perfiles personalizados). También puedes navegar a View related devices (Ver dispositivos relacionados) en la página de NDM, filtrado al dispositivo o dispositivos a los que se aplica el perfil.
Solucionar problemas
¿Qué es un perfil?
Un perfil es un archivo de configuración que define los metadatos, métricas y etiquetas a recopilar de un dispositivo. Consulta definición de metadatos para obtener más información.
¿Qué es un escaneo de dispositivos?
Un escaneo de dispositivo realiza un recorrido de SNMP completo del dispositivo, recopilando todos los datos disponibles y reenviándolos a Datadog para su visualización en la interfaz de usuario. Este proceso te ayuda a identificar los OIDs disponibles en el dispositivo y añadirlos al perfil para su supervisión.
¿Por qué no veo dispositivos coincidentes?
Si no se encuentran dispositivos coincidentes, puede deberse a las siguientes razones:
El perfil está en modo borrador:
Los borradores de perfiles no se aplican al Agent. Para empezar a monitorizar los dispositivos con tu perfil, debes sincronizarlo con el Agent o los Agents. Para ello, abre el perfil y haz clic en el botón [Save & Sync Agents] (Guardar y sincronizar Agents)(#apply-a-profile-to-created-devices).
El perfil se aplica, pero no coincide con ningún dispositivo:
Los perfiles se asocian a los dispositivos mediante su SysObjectID. Asegúrate de que el SysObjectID especificado en el perfil coincide con uno o varios de los dispositivos monitorizados.
Múltiples perfiles tienen el mismo SysObjectID:
Los perfiles se emparejan con los dispositivos utilizando su SysObjectID. Si varios perfiles comparten el mismo SysObjectID, pueden producirse conflictos de correspondencia en el Agent. Asegúrate de que cada SysObjectID se asigna a un solo perfil.
¿Por qué no se escanea un dispositivo?
El escaneo del dispositivo puede tardar hasta 10 minutos en completarse. Puedes consultar el progreso del escaneo en la interfaz de usuario. Si se producen errores, intenta reiniciar el escaneo o seleccionar un [dispositivo de referencia] diferente (#step-3-select-reference-devices).
¿Qué ocurre si no tengo activada la configuración remota en mis recolectores?
Si estás utilizando una versión del Agent anterior a 7.47.0 y no tienes ya activada manualmente la Configuración remota en tus hosts, no podrás activar escaneos de dispositivos ni sincronizar perfiles con Agents a través de la interfaz de usuario. Sin embargo, puedes realizar estos pasos manualmente.
Para escanear un dispositivo, sigue las instrucciones de la interfaz de usuario:
O, para aplicar los perfiles a tus Agents manualmente:
Guarda el perfil.
Haz clic en el botón de descarga para guardar un archivo zip con todos tus perfiles.
Datadog recomienda encarecidamente activar la configuración remota para garantizar una experiencia fluida basada en la interfaz de usuario y minimizar las interacciones innecesarias con el Agent.
