WARNING: Version 5.0 of Metricbeat has passed its EOL date.

This documentation is no longer being maintained and may be removed. If you are running this version, we strongly advise you to upgrade. For the latest information, see the current release documentation.

« Getting Started With Metricbeat Step 2: Configuring Metricbeat »
Elastic Docs ›Metricbeat Reference [5.0] ›Getting Started With Metricbeat

Step 1: Installing Metricbeat

edit

Step 1: Installing Metricbeat

edit

You should install Metricbeat as close as possible to the service you want to monitor. For example, if you have four servers with MySQL running, it’s recommended that you run Metricbeat on each service. This allows Metricbeat to access your service from localhost and does not cause any additional network traffic or prevent Metricbeat from collecting metrics when there are network problems. Metrics from multiple Metricbeat instances will be combined on the Elasticsearch server.

To download and install Metricbeat, use the commands that work with your system (deb for Debian/Ubuntu, rpm for Redhat/Centos/Fedora, mac for OS X, and win for Windows).

If you use Apt or Yum, you can install Metricbeat from our repositories to update to the newest version more easily.

See our download page for other installation options, such as 32-bit images.

deb:

curl -L -O https://artifacts.elastic.co/downloads/beats/metricbeat/metricbeat-5.0.2-amd64.deb
sudo dpkg -i metricbeat-5.0.2-amd64.deb

rpm:

curl -L -O https://artifacts.elastic.co/downloads/beats/metricbeat/metricbeat-5.0.2-x86_64.rpm
sudo rpm -vi metricbeat-5.0.2-x86_64.rpm

mac:

curl -L -O https://artifacts.elastic.co/downloads/beats/metricbeat/metricbeat-5.0.2-darwin-x86_64.tar.gz
tar xzvf metricbeat-5.0.2-darwin-x86_64.tar.gz

win:

  1. Download the Metricbeat Windows zip file from the downloads page.
  2. Extract the contents of the zip file into C:\Program Files.
  3. Rename the metricbeat-<version>-windows directory to Metricbeat.
  4. Open a PowerShell prompt as an Administrator (right-click the PowerShell icon and select Run As Administrator). If you are running Windows XP, you may need to download and install PowerShell.

  5. Run the following commands to install Metricbeat as a Windows service:

    PS > cd 'C:\Program Files\Metricbeat'
PS C:\Program Files\Metricbeat> .\install-service-metricbeat.ps1

If script execution is disabled on your system, you need to set the execution policy for the current session to allow the script to run. For example: PowerShell.exe -ExecutionPolicy UnRestricted -File .\install-service-metricbeat.ps1.

Before starting Metricbeat, you should look at the configuration options in the configuration file, for example C:\Program Files\Metricbeat\metricbeat.yml. For more information about these options, see Configuration Options (Reference).

« Getting Started With Metricbeat Step 2: Configuring Metricbeat »