Versión de la integración4.0.0
Este check monitoriza IBM i de forma remota a través del Datadog Agent.
Configuración
Sigue las instrucciones a continuación para instalar y configurar este check para un Agent que se ejecuta en un host. Para entornos en contenedores, consulta las plantillas de integración de Autodiscovery para obtener orientación sobre la aplicación de estas instrucciones.
Nota: Este check no está disponible en Windows, ya que utiliza la llamada al sistema fcntl(), que es específica de sistemas operativos tipo Unix.
Instalación
El check de IBM i está incluido en el paquete del Datadog Agent.
No es necesaria ninguna instalación adicional en tu servidor.
Controlador ODBC
El check de IBM i utiliza el controlador ODBC de IBM i para conectarse de forma remota al host IBM i.
Descarga el controlador desde la página IBM i Acceso - Soluciones de clientes. Haz clic en Downloads for IBM i Access Client Solutions e inicia sesión para acceder a la página de descargas.
Elige el paquete ACS App Pkg para tu plataforma, como ACS Linux App Pkg para hosts Linux. Descarga el paquete y sigue las instrucciones de instalación para instalar el controlador.
Configuración
El check de IBM i consulta un sistema IBM i de forma remota, desde un host que ejecuta el Datadog Agent. Para comunicarte con el sistema IBM i, debes configurar el controlador ODBC de IBM i en el host que ejecuta el Datadog Agent.
Controlador ODBC
Una vez instalado el controlador ODBC, busca los archivos de configuración de ODBC: odbc.ini y odbcinst.ini. Las localizaciones pueden variar en función de tu sistema. En Linux, pueden estar en el directorio /etc o en el directorio /etc/unixODBC.
Copia estos archivos de configuración en elentorno del Agent integrado, como /opt/datadog-agent/embedded/etc/ en hosts Linux.
El archivo odbcinst.ini define los controladores ODBC disponibles para el Agent. Cada sección define un controlador. Por ejemplo, la siguiente sección define un controlador denominado IBM i Access ODBC Driver 64-bit:
[IBM i Access ODBC Driver 64-bit]
Description=IBM i Access for Linux 64-bit ODBC Driver
Driver=/opt/ibm/iaccess/lib64/libcwbodbc.so
Setup=/opt/ibm/iaccess/lib64/libcwbodbcs.so
Threading=0
DontDLClose=1
UsageCount=1
El nombre del controlador ODBC de IBM i es necesario para configurar el check de IBM i.
Check de IBM i
Edita el archivo ibm_i.d/conf.yaml, que se encuentra en la carpeta conf.d/ en la raíz del directorio de configuración del Agent, para empezar a recopilar los datos de rendimiento de IBM i. Consulta el ibm_i.d/conf.yaml de ejemplo para conocer todas las opciones de configuración disponibles.
Utiliza el nombre del controlador del archivo obdcinst.ini.
Reinicia el Agent.
Validación
Ejecuta el subcomando de estado del Agent y busca ibm_i en la sección Checks.
Datos recopilados
Métricas
ibm_i.asp.io_requests_per_s
(gauge) | The average number of I/O requests for read and write operations that occurred per second
Shown as unit |
ibm_i.asp.percent_busy
(gauge) | The percentage of time the disk unit is in use
Shown as percent |
ibm_i.asp.percent_used
(gauge) | The percentage consumed from the disk unit
Shown as percent |
ibm_i.asp.unit_space_available
(gauge) | The space on the unit available for use
Shown as byte |
ibm_i.asp.unit_storage_capacity
(gauge) | The storage capacity of the unit
Shown as byte |
ibm_i.job.active_duration
(gauge) | The amount of time a job has been active
Shown as second |
ibm_i.job.cpu_usage
(gauge) | The CPU usage by a job |
ibm_i.job.cpu_usage.pct
(gauge) | The CPU usage by a job as a percentage
Shown as percent |
ibm_i.job.jobq_duration
(gauge) | The amount of time a job has been in the JOBQ status
Shown as second |
ibm_i.job.status
(gauge) | Whether a job is currently active or not. |
ibm_i.job.temp_storage
(gauge) | The amount of temporary storage that is currently allocated to a job
Shown as mebibyte |
ibm_i.job_queue.held_size
(gauge) | The number of jobs in *HELD status in a job queue
Shown as unit |
ibm_i.job_queue.released_size
(gauge) | The number of jobs in *RELEASED status in a job queue
Shown as unit |
ibm_i.job_queue.scheduled_size
(gauge) | The number of jobs in *SCHEDULED status in a job queue
Shown as unit |
ibm_i.job_queue.size
(gauge) | The number of jobs in a job queue
Shown as unit |
ibm_i.message_queue.critical_size
(gauge) | The number of critical messages in a system message queue
Shown as unit |
ibm_i.message_queue.size
(gauge) | The number of messages in a system message queue
Shown as unit |
ibm_i.pool.defined_size
(gauge) | The size of a pool as defined in the shared pool, subsystem description, or system value QMCHPOOL
Shown as mebibyte |
ibm_i.pool.reserved_size
(gauge) | The amount of storage in a pool reserved for system use
Shown as mebibyte |
ibm_i.pool.size
(gauge) | The amount of main storage in a pool
Shown as mebibyte |
ibm_i.subsystem.active
(gauge) | Whether a subsystem is currently active |
ibm_i.subsystem.active_jobs
(gauge) | The number of jobs currently active in a subsystem
Shown as unit |
ibm_i.system.configured_cpus
(gauge) | The total number of configured CPUs for the partition.
Shown as unit |
ibm_i.system.cpu_usage
(gauge) | The average CPU utilization for all the active processors.
Shown as percent |
ibm_i.system.current_cpu_capacity
(gauge) | The processor units that are being used in the partition. |
ibm_i.system.normalized_cpu_usage
(gauge) | The normalized percentage of CPU utilization for processing units in use.
Shown as percent |
ibm_i.system.shared_cpu_usage
(gauge) | The percentage of the total shared processor pool capacity used by all partitions using the pool.
Shown as percent |
Eventos
El check de IBM i no incluye eventos.
Solucionar problemas
¿Necesitas ayuda? Ponte en contacto con el equipo de asistencia de Datadog.
