For any GLPI agent problem or issue, you need to use GitHub issue tracker, and report your issue with all the requested informations. This requires an GitHub user account.
Before reporting your problem, always take a look at the opened and closed GitHub issues by updating the Filters field and check if your problem has still not been addressed. You should also search for any GLPI-Agent discussion that could be related to your problem.
You have to use english, for the sake of internationalization.
Always describe your problem clearly and precisely, for someone without any prior knowledge of your environment.
To do so, always describe:
the operating system on which the GLPI agent is running,
the GLPI agent version you're using and the way you installed it,
the problem itself, eventually including log extract or agent run output,
what you're expecting
You can obtain a more verbose output when running the agent from the console by using
--debug option to set debug level 1,
or by using
--debug --debug options to set debug level 2. You can also set the debug parameter in configuration to
and restart the daemon or service.
When the issue is related to some missing or invalid value, it can be caused by a parsing error while processing external data (a command output, a file, whatever...). In order to reproduce the problem and find a way to fix it, we need a sample of those data.
You can then attach the relevant file or command output as an attachement to the issue report. If there is any privacy concern, try to obfuscate sensible data or ask for an email where to send it.
On unix/linux, when running any command for such purpose, you always must unset locales first to avoid localized output:
Here are other command-specific advices:
Windows WMI queries can be exported with
wmic path <somequery> get /Format:list > <somefile.txt>
Windows registry content can be exported with
regedit /e <somefile.reg> <somekey>
dmidecode output can be generated on any system, including windows, as we ship a
dmidecode executable in the agent windows packaging, under the
"C:\Program Files\GLPI-Agent\glpi-agent\perl\bin\dmidecode" > dmidecode-output.txt
On unix/linux, just run the command in a
Snmpwalk output can be generated with the following command under unix/linux:
snmpwalk -v <version> -c <community> -t 15 -Cc -On -Ox <somehost> .1 > walk-filename.walk
Using an explicit root OID (.1 here), a non-default timeout (
15 seconds, the same one as the agent default), and disabling internal consistency checks (
-Cc) are required to extract all possible data.
-Ox is not mandatory but can help to enhance debugging discovery and inventory tasks as we may not know anything about the related MIB. So just having full numeric values can help.
-On is required to keep OID numerically to be sure to have a fully compliant snmp walk.
Joining known private MIBs related to your device could be really useful. You always can share them privately if you don't have the right to make them public.
When reporting a snmp walk, list all possible expected data you can know by another way, and at least the missing ones, like:
accurate model name
device mac address