Configure Sysdig Monitor Using Agent Modes

Agent modes provide the ability to control metric collection to fit your scale and specific requirement. You can choose one of the following modes to do so:

  • Monitor

  • Monitor Light

  • Troubleshooting

  • Essentials

Using a stripped-down mode limits collection of unneeded metrics, which in turn prevents the consumption of excess resources and helps reduce expenses.

Monitor

The Monitor mode offers an extensive collection of metrics. We recommend this mode to monitor enterprise environments.

monitor is the default mode if you are running the Enterprise tier. To switch back to the Monitor mode from a different mode, do one of the following:

  • Add the following to the dragent.yaml file and restart the agent:

    feature:  
      mode: monitor
  • Remove the parameter related to the existing mode from the dragent.yaml file and restart the agent. For example, to switch from troubleshooting mode to monitor, delete the following lines:

    feature:  
      mode: troubleshooting

Monitor Light

Monitor Light caters to the users that run agents in a resource-restrictive environment, or to those who are interested only in a limited set of metrics.

Monitor Light provides CPU, Memory, File, File system, and Network metrics. For more information, see Metrics Available in Monitor Light.

Enable Monitor Light Mode

To switch to the Monitor Light mode, edit the dragent.yaml file:

  1. Open the dragent.yaml file.

  2. Add the following configuration parameter:

    feature:  
      mode: monitor_light
  3. Restart the agent.

Troubleshooting

Troubleshooting mode offers sophisticated metrics with detailed diagnostic capabilities. Some of these metrics are heuristic in nature.

In addition to the extensive metrics available in the Monitor mode, Troubleshooting mode provides additional metrics such as net.sql and additional segmentation for file and network metrics. For more information, see Additional Metrics Values Available in Troubleshooting.

Enable Troubleshooting Mode

To switch to the Troubleshooting mode, edit the dragent.yaml file:

  1. Open the dragent.yaml file.

  2. Add the following configuration parameter:

    feature:  
      mode: troubleshooting
  3. Restart the agent.

Essentials Mode

Essentials mode offers the most necessary metrics. This is the default mode if you are using the Essentials tier.

As compared to the metrics available in the default monitor mode, the Network metrics will not be reported in the essentials mode. For more information, see Metrics Not Available in Essentials Mode.

Enable Essentials Mode

To switch to the Essentials mode, edit the dragent.yaml file:

  1. Open the dragent.yaml file.

  2. Add the following configuration parameter:

    feature:  
      mode: essentials
  3. Restart the agent.