Fortinet black logo

User Guide

Agent/Metric not showing up in the Control Panel

24.1.0
Copy Link
Copy Doc ID af1daa65-c273-11ec-9fd1-fa163e15d75b:449536
Download PDF

Agent/Metric not showing up in the Control Panel

Why does this happen?

Normally the Windows and Linux Agents will sync to your control panel after a few moments once there is enough data gathered for the metrics. This also applies to newly added plugins like the ones for Nginx or Jboss. It is common to wait up to 5 minutes or more for the freshly installed Agent or plugin to show in your Control Panel.

This is caused by the Agent’s metadata having not been synced for the first time yet or the information being out of date. In short, metadata is all the information about the plugins and metrics that are available to monitor for that server that can be synced to FortiMonitor. Once installed, our agent ‘phones home’ about once every minute and rebuilds and refreshes all the cached metadata once per hour. If you recently installed a new monitoring plugin, It is likely that it was recognized but not pulled into your agent metrics. After being added to your plugins folder and having the Agent recognize a new plugin is installed, it does take a few minutes to gather enough data to display metrics.

Using the Control Panel

You can manually tell the Agent to rebuild metadata by clicking the Rebuild Metadata button on a server's Instance Details page. This is useful if you drop in a new plugin, write your own, or make a change and need it to reload the code as soon as possible.

Linux Users

If you are a Linux user, you can also run the shell version of the Agent to rebuild the metadata with the command below. Keep in mind that there will be no output and the terminal may appear to freeze for up to a minute depending on how many plugins and the metrics that you are monitoring:

For the panopta-agent:

python /usr/bin/panopta-agent/panopta_agent.py --rebuild-metadata

For the fm-agent:

python3 /usr/bin/fm-agent/fm_agent.py --rebuild-metadata

Windows Users

If you are using the Windows agent, you can open your server’s services, then right-click and restart the service. Once restarted the agent will automatically rebuild its metadata and sync to our servers.

Agent/Metric not showing up in the Control Panel

Why does this happen?

Normally the Windows and Linux Agents will sync to your control panel after a few moments once there is enough data gathered for the metrics. This also applies to newly added plugins like the ones for Nginx or Jboss. It is common to wait up to 5 minutes or more for the freshly installed Agent or plugin to show in your Control Panel.

This is caused by the Agent’s metadata having not been synced for the first time yet or the information being out of date. In short, metadata is all the information about the plugins and metrics that are available to monitor for that server that can be synced to FortiMonitor. Once installed, our agent ‘phones home’ about once every minute and rebuilds and refreshes all the cached metadata once per hour. If you recently installed a new monitoring plugin, It is likely that it was recognized but not pulled into your agent metrics. After being added to your plugins folder and having the Agent recognize a new plugin is installed, it does take a few minutes to gather enough data to display metrics.

Using the Control Panel

You can manually tell the Agent to rebuild metadata by clicking the Rebuild Metadata button on a server's Instance Details page. This is useful if you drop in a new plugin, write your own, or make a change and need it to reload the code as soon as possible.

Linux Users

If you are a Linux user, you can also run the shell version of the Agent to rebuild the metadata with the command below. Keep in mind that there will be no output and the terminal may appear to freeze for up to a minute depending on how many plugins and the metrics that you are monitoring:

For the panopta-agent:

python /usr/bin/panopta-agent/panopta_agent.py --rebuild-metadata

For the fm-agent:

python3 /usr/bin/fm-agent/fm_agent.py --rebuild-metadata

Windows Users

If you are using the Windows agent, you can open your server’s services, then right-click and restart the service. Once restarted the agent will automatically rebuild its metadata and sync to our servers.