thorhs/node_exporter_aix

Prometheus node_exporter clone for AIX servers, written in C++ utilizing libperfstat

Node exporter for AIX

Prometheus exporter for hardware and OS metrics exposed by AIX, written in C++ utilizing the libperfstat library supplied with AIX.

Collectors

There is varying support for various subsystems. The table below below list all existing collectors.

All collectors are enabled by default. If collectors are specified on the command line, only thoes collectors will be enabled.

Default port

Default port used by this node exporter is :9100.

The port can be changed with the -p flag:

./build/node_exporter_aix -p 9101

Enabled by default

flag	Description
-C	Compat statistics, emulate linux node_exporter
-c	CPU statistics
-A	disk adapter statistics
-D	disk path statistics
-M	memory page statistics
-m	memory statistics
-d	disk statistics
-i	net interface statistics
-a	net adapter statistics
-b	net buffer statistics
-p	partition statistics

Install package

installp -ac -d <package_file.bff>

This will install the program into /usr/local/bin

The install will also create a SRC service named node_exporter_aix. Deinstall should remove the service. Installing will also start the exporter with default parameters.

Running

If the exporter was installed as a .bff packge the exporter is started using SRC:

startsrc -s node_exporter_aix

To configure parameters, you can either add parameters to the SRC service with the -a parameter:

chssys -p /usr/local/bin/node_exporter_aix -s node_exporter_aix -u root -R -S -f 9 -n 15 -a "-cdP"

Please note, the service is overwritten on with the .bff package.

Building and running

Prerequisites:

• AIX 7.1 (older may work, not tested)

• GCC C++17 compatible compiler (AIX Toolbox)

• GNU Make (AIX Toolbox)

• bos.adt.insttools (lpp, for packaging as .bff)

Building:

export PATH=/opt/freeware/bin:$PATH # If required, to use GNU make
git submodule init
git submodule update
make
./build/node_exporter_aix

To see all available configuration flags:

./build/node_exporter_aix -h

Contributing

Please see CONTRIBUTING.md. We welcome issues, pull requests and general suggestions.

License

This program is distributed under the terms of the MIT license.

See LICENSE for details.

node_exporter_aix's Issues

Struggling with building

Hi,

I am struggling with getting this compiled, we have AIX 7.2, all prepreqs were installed but get the below error:

I extracted the zip and uploaded to the server, am I missing something?

Regards,

Ray

df stats

there is only information about volume group and not capacity filesystem :

TYPE aix_disk_free gauge

aix_disk_free{disk="hdisk1",vgname="ngamsoft",machine_serial="21475DV",lpar="GAMAY",group_id="32772"} 49664
aix_disk_free{disk="hdisk0",vgname="rootvg",machine_serial="21475DV",lpar="GAMAY",group_id="32772"} 61824

Is it possible to add "df" information or other to follow capacity of space disk ?

Regards
Frederic

Originally posted by @fredtriplefred in #1 (comment)

CPU use calculations

hi,
May you suggest please the Prometheus expression based on metrics provided by node_exporter_aix which would give the actual CPU use of AIX host?

Thanks in advance

Segmentation fault(coredump) when using -c or -C options

We have deployed the exporter to approximately 200 AIX servers of various versions and TL levels with no issues.

There are 10 servers, all atleast running AIX 7.1 that are having issues.
When we set either -C or -c and Prometheus initiates the scrape, we get a segmentation fault. This happens on all versions of the exporter that we have tested it on (1.14.3.0, 1.12.1.0, 1.8.0.0, maybe others)

./node_exporter_aix -p 50005 -a -cmdif
Node exporter for AIX version 1.14.3.0 listening on port 50005
Segmentation fault(coredump)

We tested the debug version that was posted in another segmentation fault issue, and got a little extra info:

./node_exporter_aix_debug -p 50005 -a -cmdif
Node exporter for AIX version 1.12.1.0 listening on port 50005
Number of cpu records: 160
Segmentation fault(coredump)

We found that 9 of the 10 servers have 8 SMT threads with over 128 virtual CPU’s allocated.
All the other servers that are working have less than 64 virtual cpu’s.

Is there a limit on number of CPUs that we could be hitting to cause the segmentation faults?

unable to install package on AIX 7.1

command: installp -ac -d node_exporter_aix.1.14.3.0.bff

error : 0503-438 installp: This function of installp requires a list of
installable filesets to be provided.

Segmentation fault while using node_exporter 1.14.3.0 or 1.12.1.0

On AIX 7.2 TL5, we see segmentation fault on 1.12.1.0, upgraded to latest 1.14.3.0 but that too remains the same.

[1]+ Segmentation fault (core dumped) /usr/local/bin/node_exporter_aix -acMdiPf -p 10051

LPAR has many disks and 6 fiber adapters and quite busy ...Can someone help?

doesn't work on AIX 6.1

hello

I just want to confirm It doesn't work on AIX 6.1

Need Query For the Peramiters

Hey! I have successfully installed it but unfortunately, I am unable to show the data on Grafana. As I don't know the query I have seen the examples can you please tell me the queries?

List of processes running on AIX

hi,
Could you advise please if there is any chance that list of processes running on aix will be added to metrics returned by exporter?

Thanks
Oleg

"Segmentation fault (core dumped)" when using "-D" parameter

On some servers with a large number of diskpaths (several hundred), an error occurs when using the "-D" parameter:

/usr/local/bin/node_exporter_aix -cAMmdiabPfvFD

Node exporter for AIX version 1.14.3.0 listening on port 9100
Segmentation fault (core dumped)

Without "-D" everything works fine, the metrics are available:
/usr/local/bin/node_exporter_aix -cAMmdiabPfvF

Is it possible to somehow solve this?
Overall, it’s a great utility, thank you!)