Présentation
Ce check permet de surveiller à distance IBM i avec l’Agent Datadog.
Configuration
Suivez les instructions ci-dessous pour installer et configurer ce check lorsque l’Agent est exécuté sur un host. Consultez la documentation relative aux modèles d’intégration Autodiscovery pour découvrir comment appliquer ces instructions à des environnements conteneurisés.
Installation
Le check IBM i est inclus avec le package de l’Agent Datadog.
Vous n’avez donc rien d’autre à installer sur votre serveur.
Pilote ODBC
Le check IBM i utilise le pilote ODBC IBM i pour se connecter à distance au host IBM i.
Téléchargez le pilote à partir de la page IBM i Access - Client Solutions. Cliquez sur Downloads for IBM i Access Client Solutions et connectez-vous pour accéder à la page des téléchargements.
Choisissez le package ACS App Pkg pour votre plateforme, par exemple ACS Linux App Pkg pour les hosts Linux. Téléchargez le package et suivez les instructions d’installation du pilote.
Configuration
Le check IBM i envoie des requêtes à distance vers un système IBM i depuis un host sur lequel l’Agent Datadog s’exécute. Pour communiquer avec le système IBM i, vous devez configurer le pilote ODBC IBM i sur le host sur lequel l’Agent Datadog s’exécute.
Pilote ODBC
Une fois le pilote ODBC installé, recherchez les fichiers de configuration ODBC : odbc.ini et odbcinst.ini. L’emplacement peut varier selon votre système. Sur Linux, ils peuvent se trouver dans le répertoire /etc ou dans la répertoire /etc/unixODBC.
Copiez ces fichiers de configuration dans l’environnement intégré de l’Agent, par exemple /opt/datadog-agent/embedded/etc/ sur les hosts Linux.
Le fichier odbcinst.ini définit les pilotes ODBC disponibles pour l’Agent. Chaque section définit un pilote. Par exemple, la section suivante définit un pilote intitulé 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
Le nom du pilote ODBC IBM i est nécessaire pour configurer le check IBM i.
Check IBM i
Modifiez le fichier ibm_i.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent pour commencer à recueillir vos données de performance IBM i. Consultez le fichier d’exemple ibm_i.d/conf.yaml pour découvrir toutes les options de configuration disponibles.
Utilisez le nom du pilote provenant du fichier obdcinst.ini.
Redémarrez l’Agent.
Validation
Lancez la sous-commande status de l’Agent et cherchez ibm_i dans la section Checks.
Données collectées
Métriques
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 |
Événements
Le check IBM i n’inclut aucun événement.
Dépannage
Besoin d’aide ? Contactez l’assistance Datadog.
