github-mirrors/logstash
1
0
Fork 0
mirror of https://github.com/elastic/logstash.git synced 2025-04-23 22:27:21 -04:00
Code Issues Projects Releases Packages Wiki Activity

Merge pull request #1090 from jamtur01/newlaunch

Browse source 
Fixed docs to reflect bin/logstash and other minor edits
This commit is contained in:
Jordan Sissel 2014-02-19 07:33:57 -08:00
commit 6fd20a98a6
2 changed files with 29 additions and 17 deletions
Download patch file Download diff file Expand all files Collapse all files

39
docs/tutorials/10-minute-walkthrough/index.md
View file

@ -10,13 +10,20 @@ layout: content_right
* [logstash-%VERSION%.tar.gz](https://download.elasticsearch.org/logstash/logstash/logstash-%VERSION%.tar.gz)
curl -O https://download.elasticsearch.org/logstash/logstash/logstash-%VERSION%.tar.gz
### Unpack it
tar -xzf logstash-%VERSION%.tar.gz
cd logstash-%VERSION%
### Requirements:
* java
* Java
### The Secret:
logstash is written in JRuby, but I release standalone jar files for easy
Logstash is written in JRuby, but I release standalone jar files for easy
deployment, so you don't need to download JRuby or most any other dependencies.
I bake as much as possible into the single release file.
@ -29,9 +36,9 @@ I bake as much as possible into the single release file.
### Run it:
java -jar logstash-%VERSION%-flatjar.jar agent -f hello.conf
bin/logstash agent -f hello.conf
Type stuff on standard input. Press enter. Watch what event logstash sees.
Type stuff on standard input. Press enter. Watch what event Logstash sees.
Press ^C to kill it.
## Step 3 - Add ElasticSearch
@ -42,14 +49,14 @@ Press ^C to kill it.
### Run it:
java -jar logstash-%VERSION%-flatjar.jar agent -f hello-search.conf
bin/logstash agent -f hello-search.conf
Same config as step 2, but now we are also writing events to ElasticSearch. Do
a search for `*` (all):
curl 'http://localhost:9200/_search?pretty=1&q=*'
## Step 4 - logstash web
## Step 4 - Logstash web
The previous step is good, but a better frontend on elasticsearch would help!
@ -57,22 +64,22 @@ The same config as step 3 is used.
### Run it:
java -jar logstash-%VERSION%-flatjar.jar agent -f hello-search.conf -- web
bin/logstash agent -f hello-search.conf web
The above runs both the agent and the logstash web interface in the same
The above runs both the agent and the Logstash web interface in the same
process. Useful for simple deploys.
### Use it:
Go to the logstash web interface in browser: <http://localhost:9292/>
Go to the Logstash web interface in browser: <http://localhost:9292/>
Type stuff on stdin on the agent, then search for it in the web interface.
Type stuff on `STDIN` on the agent, then search for it in the web interface.
## Step 5 - real world example
Let's backfill some old apache logs. First, let's use grok.
Let's backfill some old Apache logs. First, let's use grok.
Use the ['grok'](../../filters/grok) logstash filter to parse logs.
Use the ['grok'](../../filters/grok) Logstash filter to parse logs.
### Download
@ -81,9 +88,9 @@ Use the ['grok'](../../filters/grok) logstash filter to parse logs.
### Run it
java -jar logstash-%VERSION%-flatjar.jar agent -f apache-parse.conf
bin/logstash agent -f apache-parse.conf
Logstash will now be listening on TCP port 3333. Send an apache log message at it:
Logstash will now be listening on TCP port 3333. Send an Apache log message at it:
nc localhost 3333 < apache_log.1
@ -100,7 +107,7 @@ Same as the previous step, but we'll output to ElasticSearch now.
### Run it
java -jar logstash-%VERSION%-flatjar.jar agent -f apache-elasticsearch.conf -- web
bin/logstash agent -f apache-elasticsearch.conf web
Logstash should be all set for you now. Start feeding it logs:
@ -108,7 +115,7 @@ Logstash should be all set for you now. Start feeding it logs:
nc localhost 3333 < apache_log.2
Go to the logstash web interface in browser: <http://localhost:9292/>
Go to the Logstash web interface in browser: <http://localhost:9292/>
Try some search queries. To see all the data, search for `*` (no quotes). Click
on some results, drill around in some logs.

7
docs/tutorials/getting-started-with-logstash.asciidoc
View file

@ -30,8 +30,13 @@ First, we're going to download the pre-built logstash binary and run it with a v
----
curl -O https://download.elasticsearch.org/logstash/logstash/logstash-%VERSION%.tar.gz
----
Now you should have the file named 'logstash-%VERSION%.tar.gz' on your local filesystem. Let's run it:
Now you should have the file named 'logstash-%VERSION%.tar.gz' on your local filesystem. Let's unpack it:
----
tar zxvf logstash-%VERSION%.tar.gz
cd logstash-%VERSION%
---
Now let's run it:
---
bin/logstash -e 'input { stdin { } } output { stdout {} }'
----