Skip to content

Latest commit

 

History

History
122 lines (75 loc) · 5.37 KB

quick-install.md

File metadata and controls

122 lines (75 loc) · 5.37 KB
Raw

Quick Install

The SignalFx Smart Agent is a metric-based agent written in Go that is used to monitor infrastructure and application services from a variety of environments.

The Smart Agent contains three main components:

Component Description
Monitors This component collects metrics from the host and applications. For a list of supported monitors and their configurations, see Monitor Configuration.
Observers This component collects metrics from services that are running in your environment. For a list of supported observers and their configurations, see Observer Configuration.
Writer This component collects metrics from configured monitors and then sends these metrics to SignalFx on a regular basis. If you are expecting your monitors to send large volumes of metrics through a single agent, then you must update the configurations. To learn more, see Agent Configurations.

Installation

Review pre-installation requirements for the Smart Agent

Before you download and install the Smart Agent on a single host, review the requirements below.

(For other installation options, including bulk deployments, see Advanced Installation Options.)

Please note that the Smart Agent does not support Mac OS.

General requirements

  • You must have access to your command line interface.
  • You must uninstall or disable any previously installed collector agent from your host, such as collectd.

Linux requirements

  • You must run kernel version 2.6 or higher for your Linux distribution.

Windows requirements

  • You must run .Net Framework 3.5 on Windows 8 or higher.
  • You must run Visual C++ Compiler for Python 2.7.

Step 1. Install the SignalFx Smart Agent on your host

Linux

Note: This content appears on a SignalFx documentation page and on the Setup tab of the Smart Agent tile in the SignalFx UI. The following code to install the current version works only if you are viewing these instructions on the Setup tab.

From the Setup tab, copy and paste the following code into your command line:

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

Windows

Note: This content appears on a SignalFx documentation page and on the Setup tab of the Smart Agent tile in the SignalFx UI. The following code to install the current version works only if you are viewing these instructions on the Setup tab.

From the Setup tab, copy and paste the following code into your command line:

& {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 will be installed as a Windows service and will log to the Windows Event Log.

Step 2. Confirm your Installation

  1. To confirm your installation, enter the following command on the Linux or Windows command line:

    sudo signalfx-agent status

    The return should be similar to the following example:

    SignalFx Agent version:           4.7.6
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

  2. To confirm your installation, enter the following command on the Linux or Windows command line:

    Command Description
    signalfx-agent status config This command shows resolved config in use by the Smart Agent.
    signalfx-agent status endpoints This command shows discovered endpoints.
    signalfx-agent status monitors This command shows active monitors.
    signalfx-agent status all This command shows all of the above statuses.

Troubleshoot the Smart Agent installation

If you are unable to install the Smart Agent, consider reviewing your error logs:

For Linux, use the following command to view error logs via Journal:

journalctl -u signalfx-agent | tail -100

For Windows, review the event logs.

For additional installation troubleshooting information, including how to review logs, see Frequently Asked Questions.

Review additional documentation

After a successful installation, learn more about the SignalFx agent and the SignalFx UI.