Using the Agent Console

Sysdig provides an Agent Console to interact with the Sysdig agent. This is a troubleshooting tool to help you download configuration files and investigate agent configuration problems quickly.

Enable Agent Console

This is currently turned off by default. To turn it on, edit the following in the dragent.yaml file:

command_line:
  enabled: true

Access Agent Console

Note

Currently, Agent Console is disabled by default. Only Sysdig support can access the Agent Console at this point.

  1. From Explore click the Groupings drop-down.

  2. Select Hosts & Container.

  3. Click the desired host to investigate the corresponding agent configuration.

  4. Click Options (three dots) on the right upper corner of the Explore tab.

  5. Click Agent Console.

Agent Console Commands

View Version

Run the following to find the version of the agent running in your environment:

$ version

An example output:

11.2.0

View Agent Configuration

Run the following to view the configuration of the agent running in your environment:

$ configuration show-dragent-yaml
$ configuration show-configmap-yaml
$ configuration show-default-yaml
$ configuration show-backend-yaml 
 

The output displays the configuration file. Sensitive data such as the credentials are obfuscated.

customerid: "********"
watchdog:
  max_memory_usage_mb: 2048

Troubleshoot Prometheus Metrics Collection

Provides commands to help troubleshoot Prometheus targets configured in your environment. For example, the following commands display and scrape the Prometheus endpoints respectively.

$ prometheus target show
$ prometheus target scrape

Security Considerations

  • User-sensitive configuration is obfuscated and not visible through the CLI.

  • All the information is read-only. You cannot currently change any configuration by using the Agent console.

  • Runs completely inside the agent. It does not use bash or any other Linux terminals to prevent the risk of command injection.

  • Runs only via a TLS connection with the Sysdig backend.

  • To turn off the command line output, edit the following in the dragent.yaml file:

    command_line:
      enabled: false