mirror of
https://github.com/elastic/logstash.git
synced 2025-04-25 07:07:54 -04:00
DeDe Morton
parent
a8e9c78c9d
commit
0688403105
2 changed files with 99 additions and 90 deletions
103
docs/static/getting-started-with-logstash.asciidoc
vendored
103
docs/static/getting-started-with-logstash.asciidoc
vendored
|
|
@ -2,11 +2,18 @@
|
||||||
== Getting Started with Logstash
|
== Getting Started with Logstash
|
||||||
|
|
||||||
This section guides you through the process of installing Logstash and verifying that everything is running properly.
|
This section guides you through the process of installing Logstash and verifying that everything is running properly.
|
||||||
Later sections deal with increasingly complex configurations to address selected use cases.
|
Later sections deal with increasingly complex configurations to address selected use cases. This section includes the
|
||||||
|
following topics:
|
||||||
|
|
||||||
|
* <<installing-logstash>>
|
||||||
|
* <<first-event>>
|
||||||
|
* <<advanced-pipeline>>
|
||||||
|
* <<stalled-shutdown>>
|
||||||
|
* <<pipeline>>
|
||||||
|
|
||||||
|
|
||||||
[float]
|
|
||||||
[[installing-logstash]]
|
[[installing-logstash]]
|
||||||
=== Install Logstash
|
=== Installing Logstash
|
||||||
|
|
||||||
NOTE: Logstash requires Java 7 or later. Use the
|
NOTE: Logstash requires Java 7 or later. Use the
|
||||||
http://www.oracle.com/technetwork/java/javase/downloads/index.html[official Oracle distribution] or an open-source
|
http://www.oracle.com/technetwork/java/javase/downloads/index.html[official Oracle distribution] or an open-source
|
||||||
|
|
@ -26,12 +33,100 @@ Java HotSpot(TM) 64-Bit Server VM (build 24.45-b08, mixed mode)
|
||||||
|
|
||||||
[float]
|
[float]
|
||||||
[[installing-binary]]
|
[[installing-binary]]
|
||||||
==== Installing from a downloaded binary
|
=== Installing from a Downloaded Binary
|
||||||
|
|
||||||
Download the https://www.elastic.co/downloads/logstash[Logstash installation file] that matches your host environment.
|
Download the https://www.elastic.co/downloads/logstash[Logstash installation file] that matches your host environment.
|
||||||
Unpack the file. On supported Linux operating systems, you can <<package-repositories,use a package manager>> to
|
Unpack the file. On supported Linux operating systems, you can <<package-repositories,use a package manager>> to
|
||||||
install Logstash.
|
install Logstash.
|
||||||
|
|
||||||
|
[float]
|
||||||
|
[[package-repositories]]
|
||||||
|
=== Installing from Package Repositories
|
||||||
|
|
||||||
|
We also have repositories available for APT and YUM based distributions. Note
|
||||||
|
that we only provide binary packages, but no source packages, as the packages
|
||||||
|
are created as part of the Logstash build.
|
||||||
|
|
||||||
|
We have split the Logstash package repositories by version into separate urls
|
||||||
|
to avoid accidental upgrades across major or minor versions. For all 1.5.x
|
||||||
|
releases use 1.5 as version number, for 1.4.x use 1.4, etc.
|
||||||
|
|
||||||
|
We use the PGP key
|
||||||
|
http://pgp.mit.edu/pks/lookup?op=vindex&search=0xD27D666CD88E42B4[D88E42B4],
|
||||||
|
Elastic's Signing Key, with fingerprint
|
||||||
|
|
||||||
|
4609 5ACC 8548 582C 1A26 99A9 D27D 666C D88E 42B4
|
||||||
|
|
||||||
|
to sign all our packages. It is available from http://pgp.mit.edu.
|
||||||
|
|
||||||
|
[float]
|
||||||
|
==== APT
|
||||||
|
|
||||||
|
Download and install the Public Signing Key:
|
||||||
|
|
||||||
|
[source,sh]
|
||||||
|
--------------------------------------------------
|
||||||
|
wget -qO - https://packages.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add -
|
||||||
|
--------------------------------------------------
|
||||||
|
|
||||||
|
Add the repository definition to your `/etc/apt/sources.list` file:
|
||||||
|
|
||||||
|
["source","sh",subs="attributes,callouts"]
|
||||||
|
--------------------------------------------------
|
||||||
|
echo "deb http://packages.elastic.co/logstash/{branch}/debian stable main" | sudo tee -a /etc/apt/sources.list
|
||||||
|
--------------------------------------------------
|
||||||
|
|
||||||
|
[WARNING]
|
||||||
|
==================================================
|
||||||
|
Use the `echo` method described above to add the Logstash repository. Do not
|
||||||
|
use `add-apt-repository` as it will add a `deb-src` entry as well, but we do not
|
||||||
|
provide a source package. If you have added the `deb-src` entry, you will see an
|
||||||
|
error like the following:
|
||||||
|
|
||||||
|
Unable to find expected entry 'main/source/Sources' in Release file (Wrong sources.list entry or malformed file)
|
||||||
|
|
||||||
|
Just delete the `deb-src` entry from the `/etc/apt/sources.list` file and the
|
||||||
|
installation should work as expected.
|
||||||
|
==================================================
|
||||||
|
|
||||||
|
Run `sudo apt-get update` and the repository is ready for use. You can install
|
||||||
|
it with:
|
||||||
|
|
||||||
|
[source,sh]
|
||||||
|
--------------------------------------------------
|
||||||
|
sudo apt-get update && sudo apt-get install logstash
|
||||||
|
--------------------------------------------------
|
||||||
|
|
||||||
|
[float]
|
||||||
|
==== YUM
|
||||||
|
|
||||||
|
Download and install the public signing key:
|
||||||
|
|
||||||
|
[source,sh]
|
||||||
|
--------------------------------------------------
|
||||||
|
rpm --import https://packages.elastic.co/GPG-KEY-elasticsearch
|
||||||
|
--------------------------------------------------
|
||||||
|
|
||||||
|
Add the following in your `/etc/yum.repos.d/` directory
|
||||||
|
in a file with a `.repo` suffix, for example `logstash.repo`
|
||||||
|
|
||||||
|
["source","sh",subs="attributes,callouts"]
|
||||||
|
--------------------------------------------------
|
||||||
|
[logstash-{branch}]
|
||||||
|
name=Logstash repository for {branch}.x packages
|
||||||
|
baseurl=http://packages.elastic.co/logstash/{branch}/centos
|
||||||
|
gpgcheck=1
|
||||||
|
gpgkey=http://packages.elastic.co/GPG-KEY-elasticsearch
|
||||||
|
enabled=1
|
||||||
|
--------------------------------------------------
|
||||||
|
|
||||||
|
And your repository is ready for use. You can install it with:
|
||||||
|
|
||||||
|
[source,sh]
|
||||||
|
--------------------------------------------------
|
||||||
|
yum install logstash
|
||||||
|
--------------------------------------------------
|
||||||
|
|
||||||
[[first-event]]
|
[[first-event]]
|
||||||
=== Stashing Your First Event: Basic Logstash Example
|
=== Stashing Your First Event: Basic Logstash Example
|
||||||
|
|
||||||
|
|
|
||||||
86
docs/static/repositories.asciidoc
vendored
86
docs/static/repositories.asciidoc
vendored
|
|
@ -1,86 +0,0 @@
|
||||||
[[package-repositories]]
|
|
||||||
== Package Repositories
|
|
||||||
|
|
||||||
We also have repositories available for APT and YUM based distributions. Note
|
|
||||||
that we only provide binary packages, but no source packages, as the packages
|
|
||||||
are created as part of the Logstash build.
|
|
||||||
|
|
||||||
We have split the Logstash package repositories by version into separate urls
|
|
||||||
to avoid accidental upgrades across major or minor versions. For all 1.5.x
|
|
||||||
releases use 1.5 as version number, for 1.4.x use 1.4, etc.
|
|
||||||
|
|
||||||
We use the PGP key
|
|
||||||
http://pgp.mit.edu/pks/lookup?op=vindex&search=0xD27D666CD88E42B4[D88E42B4],
|
|
||||||
Elastic's Signing Key, with fingerprint
|
|
||||||
|
|
||||||
4609 5ACC 8548 582C 1A26 99A9 D27D 666C D88E 42B4
|
|
||||||
|
|
||||||
to sign all our packages. It is available from http://pgp.mit.edu.
|
|
||||||
|
|
||||||
[float]
|
|
||||||
=== APT
|
|
||||||
|
|
||||||
Download and install the Public Signing Key:
|
|
||||||
|
|
||||||
[source,sh]
|
|
||||||
--------------------------------------------------
|
|
||||||
wget -qO - https://packages.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add -
|
|
||||||
--------------------------------------------------
|
|
||||||
|
|
||||||
Add the repository definition to your `/etc/apt/sources.list` file:
|
|
||||||
|
|
||||||
["source","sh",subs="attributes,callouts"]
|
|
||||||
--------------------------------------------------
|
|
||||||
echo "deb http://packages.elastic.co/logstash/{branch}/debian stable main" | sudo tee -a /etc/apt/sources.list
|
|
||||||
--------------------------------------------------
|
|
||||||
|
|
||||||
[WARNING]
|
|
||||||
==================================================
|
|
||||||
Use the `echo` method described above to add the Logstash repository. Do not
|
|
||||||
use `add-apt-repository` as it will add a `deb-src` entry as well, but we do not
|
|
||||||
provide a source package. If you have added the `deb-src` entry, you will see an
|
|
||||||
error like the following:
|
|
||||||
|
|
||||||
Unable to find expected entry 'main/source/Sources' in Release file (Wrong sources.list entry or malformed file)
|
|
||||||
|
|
||||||
Just delete the `deb-src` entry from the `/etc/apt/sources.list` file and the
|
|
||||||
installation should work as expected.
|
|
||||||
==================================================
|
|
||||||
|
|
||||||
Run `sudo apt-get update` and the repository is ready for use. You can install
|
|
||||||
it with:
|
|
||||||
|
|
||||||
[source,sh]
|
|
||||||
--------------------------------------------------
|
|
||||||
sudo apt-get update && sudo apt-get install logstash
|
|
||||||
--------------------------------------------------
|
|
||||||
|
|
||||||
[float]
|
|
||||||
=== YUM
|
|
||||||
|
|
||||||
Download and install the public signing key:
|
|
||||||
|
|
||||||
[source,sh]
|
|
||||||
--------------------------------------------------
|
|
||||||
rpm --import https://packages.elastic.co/GPG-KEY-elasticsearch
|
|
||||||
--------------------------------------------------
|
|
||||||
|
|
||||||
Add the following in your `/etc/yum.repos.d/` directory
|
|
||||||
in a file with a `.repo` suffix, for example `logstash.repo`
|
|
||||||
|
|
||||||
["source","sh",subs="attributes,callouts"]
|
|
||||||
--------------------------------------------------
|
|
||||||
[logstash-{branch}]
|
|
||||||
name=Logstash repository for {branch}.x packages
|
|
||||||
baseurl=http://packages.elastic.co/logstash/{branch}/centos
|
|
||||||
gpgcheck=1
|
|
||||||
gpgkey=http://packages.elastic.co/GPG-KEY-elasticsearch
|
|
||||||
enabled=1
|
|
||||||
--------------------------------------------------
|
|
||||||
|
|
||||||
And your repository is ready for use. You can install it with:
|
|
||||||
|
|
||||||
[source,sh]
|
|
||||||
--------------------------------------------------
|
|
||||||
yum install logstash
|
|
||||||
--------------------------------------------------
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue