Docs » Integrations Guide » Use the Smart Agent » Install and configure the Smart Agent » Quick Install

Quick Install πŸ”—

This integration installs the SignalFx Smart Agent application on a single host machine from which you want to collect monitoring data. Use this integration if you want to evaluate monitoring on a single host. The Smart Agent collects infrastructure monitoring, APM, and Kubernetes data.

For other installation options, including bulk deployments to production, see Install and Configure the Smart Agent.

Installation πŸ”—

Prerequisites πŸ”—

General πŸ”—

  • Ensure that you’ve installed the applications and services you want to monitor on a Linux or Windows host. SignalFx doesn’t support installing the Smart Agent on macOS or any other OS besides Linux and Windows.
  • Uninstall or disable any previously-installed collector agents from your host, such as collectd.
  • If you have any questions about compatibility between the Smart Agent and your host machine or its applications and services, contact your Splunk support representative.

Linux πŸ”—

  • Ensure that you have access to terminal or a similar command line interface application.
  • Ensure that your Linux username has permission to run the following commands:
    • curl
    • sudo
  • Ensure that your machine is running Linux kernel version 2.6.32 or higher.

Windows πŸ”—

  • Ensure that you have access to Windows PowerShell 6.
  • Ensure that your machine is running Windows 8 or higher.
  • Ensure that .Net Framework 3.5 or higher is installed.
  • While SignalFx recommends that you use TLS 1.2, if you use TLS 1.0 and want to continue using TLS 1.0, then:
    • Ensure that you support the following ciphers:
      • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA (secp256r1) - A
      • TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA (secp256r1) - A
      • TLS_RSA_WITH_AES_256_CBC_SHA (rsa 2048) - A
      • TLS_RSA_WITH_AES_128_CBC_SHA (rsa 2048) - A
      • TLS_RSA_WITH_3DES_EDE_CBC_SHA (rsa 2048) - C
      • TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 (secp256r1) - A
      • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 (secp256r1) - A
      • TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (secp256r1) - A
      • TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 (secp256r1) - A
      • TLS_RSA_WITH_AES_128_GCM_SHA256 (rsa 2048) - A
      • TLS_RSA_WITH_AES_256_GCM_SHA384 (rsa 2048) - A
      • TLS_RSA_WITH_AES_128_CBC_SHA256 (rsa 2048) - A
    • See Solving the TLS 1.0 Problem, 2nd Edition for more information.

Steps πŸ”—

Access the SignalFx UI πŸ”—

This content appears in both the documentation site and in the SignalFx UI.

If you are reading this content from the documentation site, please access the SignalFx UI so that you can paste pre-populated commands.

To access this content from the SignalFx UI:

  1. In the SignalFx UI, in the top menu, click Integrations.
  2. Locate and select SignalFx SmartAgent.
  3. Click Setup, and continue reading the instructions.

Install the Smart Agent on Linux πŸ”—

This section lists the steps for installing the Smart Agent on Linux. If you want to install the Smart Agent on Windows, proceed to the next section, Install SignalFx Smart Agent on Windows.

Copy and paste the following code into your command line or terminal:

curl -sSL https://dl.signalfx.com/signalfx-agent.sh > /tmp/signalfx-agent.sh;
sudo sh /tmp/signalfx-agent.sh --realm YOUR_SIGNALFX_REALM -- YOUR_SIGNALFX_API_TOKEN

When this command finishes, it displays the following:

The SignalFx Agent has been successfully installed.

Make sure that your system's time is relatively accurate or else datapoints may not be accepted.

The agent's main configuration file is located at /etc/signalfx/agent.yaml.

If your installation succeeds, proceed to the section Verify Your Installation. Otherwise, see the section Troubleshoot Your Installation.

Install the Smart Agent on Windows πŸ”—

Copy and paste the following code into your Windows PowerShell terminal:

& {Set-ExecutionPolicy Bypass -Scope Process -Force; $script = ((New-Object System.Net.WebClient).DownloadString('https://dl.signalfx.com/signalfx-agent.ps1')); $params = @{access_token = "YOUR_SIGNALFX_API_TOKEN"; ingest_url = "https://ingest.YOUR_SIGNALFX_REALM.signalfx.com"; api_url = "https://api.YOUR_SIGNALFX_REALM.signalfx.com"}; Invoke-Command -ScriptBlock ([scriptblock]::Create(”. {$script} $(&{$args} @params)”))}

The agent files are installed to \Program Files\SignalFx\SignalFxAgent, and the default configuration file is installed at \ProgramData\SignalFxAgent\agent.yaml if it does not already exist.

The install script starts the agent as a Windows service that writes messages to the Windows Event Log.

If your installation succeeds, proceed to the section Verify Your Installation. Otherwise, see the section Troubleshoot Your Installation.

Verify Your Installation πŸ”—

  1. To verify that you’ve successfully installed the Smart Agent, copy and paste the following command into your terminal.

For Linux:

sudo signalfx-agent status

For Windows:

& ”\Program Files\SignalFx\SignalFxAgent\bin\signalfx-agent.exe” status

The command displays output that is similar to the following:

SignalFx Agent version:           5.1.0
Agent uptime:                     8m44s
Observers active:                 host
Active Monitors:                  16
Configured Monitors:              33
Discovered Endpoint Count:        6
Bad Monitor Config:               None
Global Dimensions:                {host: my-host-1}
Datapoints sent (last minute):    1614
Events Sent (last minute):        0
Trace Spans Sent (last minute):   0
  1. To perform additional verification, you can run any of the following commands:
  • Display the current Smart Agent configuration.
sudo signalfx-agent status config
  • Show endpoints discovered by the Smart Agent.
sudo signalfx-agent status endpoints
  • Show the Smart Agent’s active monitors. These plugins poll apps and services to retrieve data.
sudo signalfx-agent status monitors

Troubleshoot Smart Agent Installation πŸ”—

If the Smart Agent installation fails, use the following procedures to gather troubleshooting information.

General troubleshooting πŸ”—

To learn how to review signalfx-agent logs, see Frequently Asked Questions.

Linux troubleshooting πŸ”—

To view recent error logs, run the following command in terminal or a similar application:

  • For sysv/upstart hosts, run:
tail -f /var/log/signalfx-agent.log
  • For systemd hosts, run:
journalctl -u signalfx-agent -f

Windows troubleshooting πŸ”—

Open Administrative Tools > Event Viewer > Windows Logs > Application to view the signalfx-agent error logs.