Erfahre, wie du Elasticsearch-Cluster in der Elastic Cloud erstellst, Benutzer mit X-Pack Security verwaltest, Kibana-Dashboards hinzufügst und Systemmetriken..

<html><head></head><body>Elastic Cloud ist das offiziell gehostete Angebot f&#xFC;r Elasticsearch und Kibana von den Entwicklern von Elasticsearch, Kibana, Beats und Logstash. Dabei handelt es sich nicht um das AWS Elasticsearch Service von Amazon. Einzelheiten erf&#xE4;hrst du in diesem <a href="/de/blog/hosted-elasticsearch-services-roundup-elastic-cloud-and-amazon-elasticsearch-service">Beitrag</a>.
Elastic Cloud bietet eine kostenlose 14-t&#xE4;gige Testversion an. Du brauchst zur Anmeldung nur deine E-Mail-Adresse, keine Kreditkarte.
In diesem Beitrag erf&#xE4;hrst du, wie du:
<ul>
	<li>Einen Elasticsearch-Cluster in Elastic Cloud erstellst.</li>
	<li>Mit X-Pack Security einen neuen Benutzer hinzuf&#xFC;gst.</li>
	<li>Mit Metricbeat Systemmetriken erfasst, an den Elasticsearch-Cluster in Elastic Cloud &#xFC;bertr&#xE4;gst und sie dann in Kibana-Dashboards visualisierst, die automatisch von Metricbeat geladen werden.&#xA0;</li>
</ul><h2> Erstelle ein Konto bei Elastic Cloud</h2>Gehe zur Website von Elastic Cloud. Starte eine&#xA0;<a href="https://www.elastic.co/de/cloud/as-a-service/signup">kostenlose Elastic Cloud Testversion</a>. Hinweis: Du kannst diesen Schritt &#xFC;berspringen, wenn du bereits ein Elastic Cloud-Konto hast.&#xA0;
<img src="https://api.contentstack.io/v2/uploads/59e0cebf3ef8e08c0d90e8f7/download?uid=blt128d83d79abf632d" data-sys-asset-uid="blt128d83d79abf632d" alt="Try_Elastic_Cloud__Hosted_Elasticsearch__for_Free___Elastic.png">
Gib deine E-Mail-Adresse ein und klicke auf die&#xA0;Start Trial. Du erh&#xE4;ltst eine Nachricht zur &#xDC;berpr&#xFC;fung deiner E-Mail-Adresse in deinem Posteingang. Klicke auf die&#xA0;Verify Email and Accept TOS, um fortzufahren.&#xA0; 
<img src="https://api.contentstack.io/v2/uploads/598db1c5b3ba08942fce2af8/download?uid=blt4c04a04b5859f0fe" data-sys-asset-uid="blt4c04a04b5859f0fe" alt="&#xC2A4;&#xD06C;&#xB9B0;&#xC0F7; 2017-08-11 21.07.57.png">&#xA0;
Lege das Passwort f&#xFC;r dein Elastic Cloud-Konto fest.
<img src="https://api.contentstack.io/v2/uploads/598db2358f6b4d840686a473/download?uid=blt04cb16dd162f6a19" data-sys-asset-uid="blt04cb16dd162f6a19" alt="&#xC2A4;&#xD06C;&#xB9B0;&#xC0F7; 2017-08-11 21.08.19.png">
 
<h2>2. Starte einen Elasticsearch-Cluster und eine Kibana-Instanz </h2>Sobald du dein Passwort erstellt hast, wirst du automatisch zur Elastic Cloud-Benutzeroberfl&#xE4;che weitergeleitet. &#xDC;ber die URL <a href="https://cloud.elastic.co">https://cloud.elastic.co</a>&#xA0;kannst du auch sp&#xE4;ter noch darauf zugreifen. 
Klicke auf&#xA0;Create Cluster, um deinen ersten Cluster einzurichten. 
<img src="https://api.contentstack.io/v2/uploads/599b3e33cd425dbf181f5d02/download?uid=blt84a8b2b5bdc77d89" data-sys-asset-uid="blt84a8b2b5bdc77d89" alt="Monitor_your_system_with_Metricbeat_on_Elastic_Cloud_-_Google_Docs.png">
W&#xE4;hle die gew&#xFC;nschte Gr&#xF6;&#xDF;e und Region f&#xFC;r den Cluster aus und klicke auf&#xA0;Create. Jetzt wird dein Elasticsearch-Cluster eingerichtet und bereitgestellt. 
<img src="https://api.contentstack.io/v2/uploads/599b4376d9dcd8a66464d858/download?uid=bltd526aa6fcf9781be" data-sys-asset-uid="bltd526aa6fcf9781be" alt="Elastic_Cloud.png">
Nachdem du deinen Elasticsearch-Cluster fertig eingerichtet hast, wird das erzeugte Passwort f&#xFC;r den&#xA0;Superuser&#xA0;elastic&#xA0;angezeigt. Dieses Passwort wird dir nur dieses eine Mal angezeigt, also notiere es und speichere/verwahre es an einem sicheren Ort.
<img src="https://api.contentstack.io/v2/uploads/598db3e4101718d222ac8ddf/download?uid=blt7ec579124c905376" data-sys-asset-uid="blt7ec579124c905376" alt="&#xC2A4;&#xD06C;&#xB9B0;&#xC0F7; 2017-08-11 21.10.25.png">&#xA0;&#xA0;
Wenn du das Passwort verlierst, kannst du es im Men&#xFC;&#xA0;Security in der Elastic Cloud Konsole zur&#xFC;cksetzen.
<img src="https://api.contentstack.io/v2/uploads/598db4c23e67ecd82fbed3b5/download?uid=bltaef407a50ebea531" data-sys-asset-uid="bltaef407a50ebea531" alt="&#xC2A4;&#xD06C;&#xB9B0;&#xC0F7; 2017-08-11 22.43.28.png">
Navigiere zum Men&#xFC;&#xA0;Overview. Dort findest du die URLs f&#xFC;r Elasticsearch und Kibana. 
<img src="https://api.contentstack.io/v2/uploads/598db5b26f0077f92223f88a/download?uid=blt88dcdba3be914b98" data-sys-asset-uid="blt88dcdba3be914b98" alt="&#xC2A4;&#xD06C;&#xB9B0;&#xC0F7; 2017-08-11 21.14.48.png">&#xA0;
 
<h2>3. Erstelle einen neuen Superuser</h2>Klicke auf die Kibana-URL, um zur Anmeldung f&#xFC;r Kibana zu gelangen. Gib beim Benutzer &#x201E;elastic&#x201C; ein und verwende das automatisch erzeugte Passwort (das du an einem sicheren Ort gespeichert hast), um dich anzumelden.
<img src="https://api.contentstack.io/v2/uploads/598db6aed537f8dd07cf6059/download?uid=blt57538ef5661b152f" data-sys-asset-uid="blt57538ef5661b152f" alt="&#xC2A4;&#xD06C;&#xB9B0;&#xC0F7; 2017-08-11 21.17.16.png">&#xA0;
Elastic Cloud umfasst mehrere X-Pack-Features, darunter Security und Monitoring.
Wenn du lieber einen bestimmten Benutzernamen samt Passwort benutzen m&#xF6;chtest, kannst du mit der Funktion Rollenbasierte Zugangskontrolle einen neuen Superuser erstellen. Gehe auf den Tab Management&#xA0;und w&#xE4;hle dann im Abschnitt Security die Option&#xA0;Users&#xA0;aus: 
<img src="https://api.contentstack.io/v2/uploads/598db79919885a05091a7254/download?uid=blt3bf4acddee169cca" data-sys-asset-uid="blt3bf4acddee169cca" alt="&#xC2A4;&#xD06C;&#xB9B0;&#xC0F7; 2017-08-11 21.35.51.png">&#xA0;
Klicke auf die Schaltfl&#xE4;che&#xA0;+ Create user.
<img src="https://api.contentstack.io/v2/uploads/598db7dc8f6b4d840686a482/download?uid=blt526034270fba8392" data-sys-asset-uid="blt526034270fba8392" alt="&#xC2A4;&#xD06C;&#xB9B0;&#xC0F7; 2017-08-11 21.36.03.png">&#xA0;
Gib den Benutzernamen, das Passwort, den vollst&#xE4;ndigen Namen, die E-Mail-Adresse und f&#xFC;r die Rolle&#xA0;superuser&#xA0;ein. Anschlie&#xDF;end speicherst du. 
<img src="https://api.contentstack.io/v2/uploads/5996768427ab71de2fb9039b/download?uid=blt4c0fbc3a6b8eaf4f" data-sys-asset-uid="blt4c0fbc3a6b8eaf4f" alt="new_user_reg.png"> 
Damit wird dein neues Superuser-Konto erstellt. 
<img src="https://api.contentstack.io/v2/uploads/599676b88f6b4d840686a697/download?uid=blt5c92f591326dce96" data-sys-asset-uid="blt5c92f591326dce96" alt="new_user_registered.png"> 
Probiere das Abmelden und erneute Anmelden mit deinem neuen Konto aus, um sicherzustellen, dass alles funktioniert.&#xA0;
<img src="https://api.contentstack.io/v2/uploads/59967720b3ba08942fce2cba/download?uid=blt8ae76430e0e3afc9" data-sys-asset-uid="blt8ae76430e0e3afc9" alt="new_login.png"> 
<h2>4. Metricbeat konfigurieren und ausf&#xFC;hren </h2>Jetzt haben wir Elasticsearch und Kibana konfiguriert und m&#xF6;chten Daten &#xFC;bertragen. In diesem Tutorial verwenden wir daf&#xFC;r&#xA0;<a href="https://www.elastic.co/de/products/beats/metricbeat" target="_blank">Metricbeat</a>.
Metricbeat erfasst alle m&#xF6;glichen Metriken von deinem System und &#xFC;bertr&#xE4;gt sie an deine Elasticsearch- oder Logstash-Instanz. Es wird als Bin&#xE4;rdatei ausgef&#xFC;hrt; du musst also die richtige Dateiversion f&#xFC;r dein Betriebssystem herunterladen. Besuche die&#xA0;<a href="https://www.elastic.co/downloads/beats/metricbeat">Metricbeat Downloadseite</a>, lade die richtige Version f&#xFC;r dein Betriebssystem herunter und entpacke es.
<img src="https://api.contentstack.io/v2/uploads/598dba00a18cb15724cad625/download?uid=blt3c5b3fe938245ce7" data-sys-asset-uid="blt3c5b3fe938245ce7" alt="&#xC2A4;&#xD06C;&#xB9B0;&#xC0F7; 2017-08-11 21.43.16.png">&#xA0;
Nach dem Entpacken findest du mehrere Dateien im metricbeat-Verzeichnis.
<img src="https://api.contentstack.io/v2/uploads/598dba65fa53cbd82236f42d/download?uid=blt832815b26f9eda83" data-sys-asset-uid="blt832815b26f9eda83" alt="&#xC2A4;&#xD06C;&#xB9B0;&#xC0F7; 2017-08-11 23.08.18.png">&#xA0;
Die Datei&#xA0;metricbeat&#xA0;(oder&#xA0;metricbeat.exe&#xA0;f&#xFC;r Windows-Betriebssysteme) startet deinen Metricbeat. Die Standardkonfiguration ist darauf ausgelegt, Daten an Elasticsearch auf&#xA0;http://localhost:9200&#xA0;zu senden. Wir m&#xFC;ssen also die Konfiguration &#xE4;ndern, damit die Daten an unseren Elastic Cloud-Cluster gesendet werden.
&#xD6;ffne&#xA0;metricbeat.yml&#xA0;mit dem Texteditor deiner Wahl.
<img src="https://api.contentstack.io/v2/uploads/599b3b875c3dbb4b7b322964/download?uid=blt60c5b918b5b3c29e" data-sys-asset-uid="blt60c5b918b5b3c29e" alt="Monitor_your_system_with_Metricbeat_on_Elastic_Cloud_-_Google_Docs.png">
Ersetze&#xA0;<code style="font-size: 12.6px;">&#x201E;localhost:9200&#x201C;</code>&#xA0;durch die URL deines neuen Elasticsearch-Clusters. 
<pre style="font-size: 12.600000381469727px;">output.elasticsearch:
 #Array of hosts to connect to.
 hosts: [&quot;localhost:9200&quot;]
</pre>Gib deinen neu erstellen Benutzernamen samt Passwort ein. Wenn du die Benutzererstellung &#xFC;bersprungen hast, kannst du &#x201E;elastic&#x201C; als Benutzernamen und das automatisch erzeugte Passwort verwenden.
<pre style="font-size: 12.600000381469727px;"> username: &quot;&lt;user id&gt;&quot; 
 password: &quot;&lt;password&gt;&quot;
</pre>Pass bei YAML mit der Grammatik auf: Du musst in jeder Zeile die richtigen Zeichenabst&#xE4;nde einhalten. username: und&#xA0;password: m&#xFC;ssen jeweils durch 2 Leerzeichen einger&#xFC;ckt werden, der Rest beginnt ohne Leerzeichen. Gib deinen neu erstellten username&#xA0;samt&#xA0;password&#xA0;ein. Wenn du die Benutzererstellung &#xFC;bersprungen hast, kannst du &#x201E;elastic&#x201C; als Benutzernamen und das automatisch erzeugte Passwort verwenden. 
Speichere die Datei metricbeat.yml. F&#xFC;hre dann metricbeat mit der Option -setup aus. So wei&#xDF; das System, dass es die Standard-Metrik-Dashboards in Kibana laden soll.
<img src="https://api.contentstack.io/v2/uploads/599b3cc35c3dbb4b7b32296a/download?uid=blt42fb4eacf4bd58ae" data-sys-asset-uid="blt42fb4eacf4bd58ae" alt="metricbeat-5_5_2-darwin-x86_64_&#x2014;_metricbeat_-c_metricbeat_yml_-setup_-e_&#x2014;_109&#xD7;20.png">
TIPP: Wenn du die Option -e beim Ausf&#xFC;hren von Metricbeat anh&#xE4;ngst, kannst du beim Ausf&#xFC;hren die Logs sehen. 
<h2>5. Sieh dir die Metricbeat-Dashboards an</h2>Beim Start von Metricbeat haben wir die Option -setup&#xA0;angeh&#xE4;ngt, um die Dashboards und Visualisierungen von Metricbeat automatisch in Kibana zu laden: 
<img src="https://api.contentstack.io/v2/uploads/598dbe948f6b4d840686a498/download?uid=bltd2f9f5fdec20c420" data-sys-asset-uid="bltd2f9f5fdec20c420" alt="&#xC2A4;&#xD06C;&#xB9B0;&#xC0F7; 2017-08-11 21.53.03.png">&#xA0;
Klicke auf das Men&#xFC; Kibana Dashboard und sieh dir die neuen Metricbeat-Dashboards an. &#xDC;berpr&#xFC;fe, ob deine Systemmetriken an Elasticsearch gesendet werden:
<img src="https://api.contentstack.io/v2/uploads/598dbf0b27ab71de2fb901d7/download?uid=bltaedf02b5587aeefb" data-sys-asset-uid="bltaedf02b5587aeefb" alt="&#xC2A4;&#xD06C;&#xB9B0;&#xC0F7; 2017-08-11 21.53.20.png">&#xA0;&#xA0;
Jetzt, da du dich vom reibungslosen Betrieb &#xFC;berzeugt hast, kannst du Metricbeat in deinen anderen Systemen einsetzen. Probiere es aus!
</body></html>

blog-metricbeat-fb.jpg

blog-metricbeat-thumb.jpg

Monitor Your System with Metricbeat and Elastic Cloud

Systemüberwachung mit Metricbeat und Elastic Cloud

Baue deinen eigenen Beat anhand von Lsbeat als Beispiel.

Beats ist die Plattform zur Entwicklung von leichtgewichtigen Open-Source Daten-Shippern, die alle möglichen Daten zur späteren Analyse an Elasticsearch senden. Wir haben Packetbeat zur Überwachung des Netzwerk-Verkehrs, Filebeat zum Abrufen der Logs von euren Servern und das neue Metricbeat, das regelmäßig statistische Daten von externen Systemen anfordert. Wenn ihr andere, eigene Daten sammeln wollt, könnt ihr auf Basis des libbeat-Frameworks ganz einfach eigene Beats schreiben. Es gibt bereits mehr als 25 <a href="/guide/en/beats/libbeat/current/community-beats.html">Community Beats</a>,&nbsp;die von der Community entwickelt wurden.
Wir stellen das Beat Generator-Paket bereit, das&nbsp;euch beim Schreiben eigener Beats hilft. In diesem Blog-Beitrag erklären wir die Erstellung eines eigenen Beats mit dem Beat Generator. Der Beat, den wir heute zu Übungszwecken schreiben, heißt <a href="https://github.com/kimjmin/lsbeat">Lsbeat</a>. Lsbeat indiziert Informationen zu Dateien und Verzeichnissen – etwa so wie der Unix-Befehl <code>ls</code>. Dieser Artikel basiert auf Unix. Wenn ihr also Windows oder ein anderes Betriebssystem nutzt, befolgt die Anweisungen für euer OS. 
<h2>Schritt 1 – Eure Golang-Umgebung einrichten</h2> Beats werden in Golang geschrieben. Beat-Entwickler müssen also Golang auf ihren Rechnern installieren. Folgt bei Bedarf den Anweisungen zur <a href="https://golang.org/doc/install">Golang-Installation</a>. Aktuell benötigen Beats mindestens Golang 1.6. Achtet darauf, eure Umgebungsvariable <code>$GOPATH</code> richtig zu setzen.
Sehen wir uns an, welchen Code wir für Lsbeat brauchen. Dies ist ein simples Golang-Programm, das ein Verzeichnis als Befehlszeilen-Argument entgegennimmt und alle Dateien und Unterverzeichnisse darin auflistet.
<pre class="prettyprint">package main
import (
 "fmt"
 "io/ioutil"
 "os"
)
func main() {
 //apply run path "." without argument.
 if len(os.Args) == 1 {
 listDir(".")
 } else {
 listDir(os.Args[1])
 }
}
func listDir(dirFile string) {
 files, _ := ioutil.ReadDir(dirFile)
 for _, f := range files {
 t := f.ModTime()
 fmt.Println(f.Name(), dirFile+"/"+f.Name(), f.IsDir(), t, f.Size())
 if f.IsDir() {
 listDir(dirFile + "/" + f.Name())
 }
 }
}
</pre>Wir verwenden dazu den Code der Funktion <code>listDir</code>. 
<h2>Schritt 2 – Generieren</h2> Zum Generieren unseres eigenen Beats nehmen wir den <a href="https://github.com/elastic/beats/tree/master/generator/beat">Beat Generator</a>. Zuerst müsst ihr aber <a href="https://github.com/audreyr/cookiecutter">cookiecutter</a>&nbsp;installieren. <a href="http://cookiecutter.readthedocs.org/en/latest/installation.html">Hier</a>&nbsp;findet ihr die Installationsanleitung. Nach der erfolgreich Installation müssen wir uns einen Namen für den Beat überlegen. Der Name muss ein zusammenhängender Ausdruck in Kleinbuchstaben sein. Für dieses Beispiel verwenden wir&nbsp;<code>lsbeat</code>.
Für das Beat-Grundgerüst solltet ihr euch das Beats Generator-Paket holen, das im <a href="https://github.com/elastic/beats">beats</a>-Repository verfügbar ist. Nach der Installation von&nbsp;<a href="https://golang.org/dl/">Golang</a>&nbsp;könnt ihr das Beats Generator-Paket mit dem Befehl <code>go get</code> herunterladen. Wenn der Befehl ausgeführt wird, landen alle Quelldateien im Pfad <code>$GOPATH/src</code>.
<pre class="prettyprint">$ go get github.com/elastic/beats
</pre>Damit die Entwicklung auf einem stabilen Branch stattfindet, wird der 5.1 Branch verwendet.
<pre class="prettyprint" style="font-size: 12.6px;">$ cd $GOPATH/src/github.com/elastic/beats
$ git checkout 5.1
</pre>Jetzt erstellt ihr euer eigenes Verzeichnis unter GOPATH und führt cookiecutter mit dem Beat Generator-Pfad aus. 
<pre class="prettyprint">$ cd $GOPATH/src/github.com/{user}
$ cookiecutter $GOPATH/src/github.com/elastic/beats/generate/beat
</pre>Cookiecutter wird euch mehrere Fragen stellen. Für project_name gebt Lsbeat und für gifthub_name&nbsp;eure GitHub-ID ein. Die nächsten beiden Fragen zu beat und beat_path sollten bereits automatisch richtig eingestellt sein. Bei der letzten Frage könnt ihr euren Vornamen und Nachnamen eintragen.
<pre class="prettyprint">project_name [Examplebeat]: lsbeat
github_name [your-github-name]: {username}
beat [lsbeat]:
beat_path [github.com/{github id}]:
full_name [Firstname Lastname]: {Full Name}
</pre>Jetzt sollte ein Verzeichnis namens lsbeat mit mehreren Dateien in unserem Ordner erzeugt worden sein. Wechseln wir doch einmal zu diesem Verzeichnis und sehen uns die automatisch erstellten Dateien an.
<pre class="prettyprint">$ cd lsbeat
$ tree
.
├── CONTRIBUTING.md
├── LICENSE
├── Makefile
├── README.md
├── beater
│ └── lsbeat.go
├── config
│ ├── config.go
│ └── config_test.go
├── dev-tools
│ └── packer
│ ├── Makefile
│ ├── beats
│ │ └── lsbeat.yml
│ └── version.yml
├── docs
│ └── index.asciidoc
├── etc
│ ├── beat.yml
│ └── fields.yml
├── glide.yaml
├── lsbeat.template.json
├── main.go
├── main_test.go
└── tests
 └── system
 ├── config
 │ └── lsbeat.yml.j2
 ├── lsbeat.py
 ├── requirements.txt
 └── test_base.py
</pre>Jetzt haben wir eine grobe Vorlage für den Beat, müssen aber noch die Abhängigkeiten festlegen und das Git-Repository einrichten.
Zuerst werden die Abhängigkeiten festgelegt: In unserem Fall ist das nur libbeat. Dann erstellen wir die grundlegenden Konfigurations- und Vorlagendateien. Später werden wir uns die Vorlagen- und Konfigurationsdateien noch genauer ansehen.
<pre class="prettyprint">$ make setup
</pre>Jetzt habt ihr euren eigenen Beat und könnt ihn in ein GitHub-Repository hochladen, um ihn mit der Community zu teilen.
<img src="https://api.contentstack.io/v2/assets/5787f6d6c0bc38f452f8188d/download?uid=bltc6313851494a95b5" data-sys-asset-uid="bltc6313851494a95b5" alt="Screen Shot 2016-07-13 at 10.53.58 AM.png">
Führt folgende Befehle aus, um Lsbeat in das GitHub-Repository zu übertragen:
<pre class="prettyprint">$ git remote add origin git@github.com:{username}/lsbeat.git
$ git push -u origin master
</pre>Jetzt haben wir einen vollständigen Beat und die erste Version davon auf GitHub veröffentlicht. Nun können wir unseren Beat schreiben, ausführen und uns detaillierter mit dem Code beschäftigen. 
<h2>Schritt 3 – Konfigurieren</h2> Sobald ihr die obigen Befehle ausführt, werden die Dateien lsbeat.yml und lsbeat.template.json automatisch erstellt. Alle grundlegenden Konfigurationseinstellungen werden bereits in diese Dateien geschrieben. 
lsbeat.yml:
<pre class="prettyprint">lsbeat:
 # Defines how often an event is sent to the output
 period: 1s
</pre><code>period</code> ist ein Parameter, der vom Generator in alle Beats eingefügt wird. Er steht für die sekündliche Prozessiteration von Lsbeat. Ändern wir <code>period</code> doch einfach von 1 auf 10 Sekunden und fügen den neuen Parameter <code>path</code>&nbsp;hinzu, um den Pfad des Oberverzeichnisses festzulegen, den das Programm scannt. Diese Parameter können wir in beat.yml unter dem Verzeichnis etc/ hinzufügen.&nbsp;
<pre class="prettyprint">lsbeat:
 # Defines how often an event is sent to the output
 period: 10s
 path: "."
</pre>Nachdem wir neue Parameter hinzugefügt haben, führen wir den Befehl <code>make update</code>&nbsp;aus, um die Änderungen für die Konfigurationsdatei lsbeat.yml zu übernehmen. Jetzt sehen wir, dass die unter etc/beat.yml hinzugefügten Parameter in lsbeat.yml verfügbar sind.
<pre class="prettyprint">$ make update
$ cat lsbeat.yml
</pre><pre class="prettyprint">################### Lsbeat Configuration Example #########################
############################# Lsbeat ######################################
lsbeat:
 # Defines how often an event is sent to the output
 period: 10s
 path: "."
###############################################################################
</pre>Nach dem Aktualisieren der Konfigurationsdateien solltet ihr config/config.go bearbeiten, um den Parameter&nbsp;<code>path</code> hinzuzufügen.
<pre class="prettyprint">package config
import "time"
type Config struct {
 Period time.Duration `config:"period"`
 Path string `config:"path"`
}
var DefaultConfig = Config{
 Period: 10 * time.Second,
 Path: ".",
}
</pre>In diesem Fall verwenden wir als Standard-Konfigurationsoptionen 10 Sekunden für period und das aktuelle Verzeichnis (.) für das Standard-Directory. 
<h2>Step 4&nbsp;- Add code</h2> Jeder Beat muss durch die Definition der Funktionen <code>Run()</code> und <code>Stop()</code> die Beater-Schnittstelle implementieren. Genauere Informationen zu dieser Schnittstelle findet ihr&nbsp;<a href="https://www.elastic.co/guide/en/beats/libbeat/master/beater-interface.html" target="_blank">hier</a>.
Dazu müsst ihr einfach nur eine Struktur namens <code>Lsbeat</code> definieren, die das Lsbeat-Objekt definiert, das die Beater-Schnittstelle implementieren soll. Hier können wir auch gleich <code>lastIndexTime</code> hinzufügen. Damit werden die Daten des letzten Zeitstempels gespeichert.
<pre class="prettyprint">type Lsbeat struct {
 done chan struct{}
 config config.Config
 client publisher.Client
 lastIndexTime time.Time
}
</pre>Außerdem muss jeder Beat die Funktion <code>New()</code> implementieren, die die Beat-Konfiguration empfängt und das Beat-Objekt vom Typ Lsbeat ausgibt.
<pre class="prettyprint">func New(b *beat.Beat, cfg *common.Config) (beat.Beater, error) {
 config := config.DefaultConfig
 if err := cfg.Unpack(&config); err != nil {
 return nil, fmt.Errorf("Error reading config file: %v", err)
 }
 ls := &Lsbeat{
 done: make(chan struct{}),
 config: config,
 }
 return ls, nil
}
</pre>Bei Lsbeat möchten wir die Funktionalität der Standardfunktion <code>Run()</code> auf den Export von Informationen zu den Dateien und Unterverzeichnissen erweitern, die in einem Verzeichnis verfügbar sind.
Bevor wir die Funktion <code>Run()</code> verändern, fügen wir aber zuerst unten in der Datei lsbeat.go die Funktion <code>listDir()</code> hinzu, um Informationen zu Dateien und und Verzeichnissen zu sammeln. Sie erzeugt Events wie:
<ul>
	<li><code>"@timestamp": common.Time(time.Now())</code></li>
	<li><code>"type": beatname</code></li>
	<li><code>"modtime": common.Time(t)</code></li>
	<li><code>"filename": f.Name()</code></li>
	<li><code>"path": dirFile + "/" + f.Name()</code></li>
	<li><code>"directory": f.IsDir()</code></li>
	<li><code>"filesize": f.Size()</code></li>
</ul><code>listDir()</code> indiziert alle Dateien und Verzeichnissen einmal, prüft aber nach dem ersten Durchlauf, ob Dateien oder Verzeichnisse erstellt oder bearbeitet wurden. So werden ab dann nur noch neue Dateien und Verzeichnisse indiziert. Der Zeitstempel des letzten Durchlaufs wird in der Variable <code>lasIndexTime</code> gespeichert.
<pre class="prettyprint">func (bt *Lsbeat) listDir(dirFile string, beatname string) {
 files, _ := ioutil.ReadDir(dirFile)
 for _, f := range files {
 t := f.ModTime()
 path := filepath.Join(dirFile, f.Name())
 if t.After(bt.lastIndexTime) {
 event := common.MapStr{
 "@timestamp": common.Time(time.Now()),
 "type": beatname,
 "modtime": common.Time(t),
 "filename": f.Name(),
 "path": path,
 "directory": f.IsDir(),
 "filesize": f.Size(),
 }
 bt.client.PublishEvent(event)
 }
 if f.IsDir() {
 bt.listDir(path, beatname)
 }
 }
}
</pre>Und vergesst beim Bibliotheken-Import nicht das Paket&nbsp;<code>io/ioutil</code>.
<pre class="prettyprint">import (
 "fmt"
 "io/ioutil"
 "time"
)
</pre>Sehen wir uns nun einmal die Funktion <code>Run()</code> an, die die Funktion <code>listDir()</code> aufruft und den Zeitstempel in der Variable <code>lasIndexTime</code> speichert.
<pre class="prettyprint">func (bt *Lsbeat) Run(b *beat.Beat) error {
 logp.Info("lsbeat is running! Hit CTRL-C to stop it.")
 bt.client = b.Publisher.Connect()
 ticker := time.NewTicker(bt.config.Period)
 for {
 now := time.Now()
 bt.listDir(bt.config.Path, b.Name) // call listDir
 bt.lastIndexTime = now // mark Timestamp
 logp.Info("Event sent")
 select {
 case &lt;-bt.done:
 return nil
 case &lt;-ticker.C:
 }
 }
}
</pre>Die Funktion <code>Stop()</code> soll die Ausführungsschleife unterbrechen und kann unverändert vom generierten Code übernommen werden:
<pre class="prettyprint">func (bt *Lsbeat) Stop() {
 bt.client.Close()
 close(bt.done)
}
</pre>Mit dem Programmieren sind wir fast fertig. Wir müssen beim Mapping neue Felder hinzufügen – und natürlich die Feldinformationen in der Datei <code>etc/fields.yml</code>.
<pre class="prettyprint">- key: lsbeat
 title: LS Beat
 description: 
 fields:
 - name: counter
 type: integer
 required: true
 description: &gt;
 PLEASE UPDATE DOCUMENTATION
 #new fiels added lsbeat
 - name: modtime
 type: date
 - name: filename
 type: text
 - name: path
 - name: directory
 type: boolean
 - name: filesize
 type: long
</pre>Und schließlich die Änderungen übernehmen.
<pre class="prettyprint">$ make update
</pre><code>filename</code> wird mit dem nGram Tokenizer analysiert. Jetzt fügen wir einen eigenen Analyser in der Datei lsbeat.template.json unter "settings" hinzu.
<pre class="prettyprint">{
 "mappings": {
 ...
 },
 "order": 0,
 "settings": {
 "index.refresh_interval": "5s",
 "analysis": {
 "analyzer": {
 "ls_ngram_analyzer": {
 "tokenizer": "ls_ngram_tokenizer"
 }
 },
 "tokenizer": {
 "ls_ngram_tokenizer": {
 "type": "ngram",
 "min_gram": "2",
 "token_chars": [
 "letter",
 "digit"
 ]
 }
 }
 }
 },
 "template": "lsbeat-*"
}
</pre><h2>Step 5&nbsp;- Build and run</h2> Jetzt können wir den Beat fertigstellen und ausführen. Führt einfach den Befehl „make“ aus, damit der Code kompiliert und in die ausführbare Binärdatei&nbsp;<code>lsbeat</code> (<code>lsbeat.exe</code> bei Windows) umgewandelt wird.
<pre class="prettyprint">$ make
</pre>Bearbeitet die Datei lsbeat.yml und legt das Stammverzeichnis für die Dateiliste fest.&nbsp;In unserem Fall nehmen wir den $GOPATH, der <code>/Users/ec2-user/go</code>. Achtet darauf, dass der vollständige Verzeichnispfad angegeben wird.
<pre class="prettyprint">lsbeat:
 # Defines how often an event is sent to the output
 period: 10s
 path: "/Users/ec2-user/go"
</pre>Achtet auch darauf, dass eure Elasticsearch- und Kibana-Instanzen laufen. Jetzt führen wir Lsbeat aus und schauen, was passiert.
<pre class="prettyprint">$ ./lsbeat
</pre>Ihr könnt mit der _cat-API prüfen, ob der Index erstellt und die Daten ordnungsgemäß indiziert werden. <img src="https://api.contentstack.io/v2/assets/5787f7b662ff8c94777fc33e/download?uid=blt47d7e8421c87b1b7" data-sys-asset-uid="blt47d7e8421c87b1b7" alt="cat.png">&nbsp; 
 Wir sehen den Index lsbeat-2016.06.03 und die Dokumentenanzahl. Fragen wir nun Lsbeat mit dem Feld filename ab, das mit dem nGram Tokenizer analysiert wird. Die Abfrage erfolgt mit dem Suchbegriff lsbe. 
<img src="https://api.contentstack.io/v2/assets/5787f7cdc0bc38f452f81a2e/download?uid=blte53a76e132c239b6" data-sys-asset-uid="blte53a76e132c239b6" alt="query.png">
Es funktioniert! Glückwunsch, ihr habt gerade einen eigenen Beat geschrieben!

beats_full_width.png

beats_blog.png

Build your own Beat

Baue deinen eigenen Beat

Start free trial

Blog Footer CTA

Sign up for Elastic Cloud free trial

Community Advocate

Jongmin Kim

By submitting you acknowledge that you've read and agree to our <a href="/legal/elastic-cloud-account-terms" target="_self">Terms of Service</a>, and you agree to receive the <a href="/legal/privacy-statement#how-we-use-the-information" target="_self">selected communications</a> at the contact details you provided above. See <a href="/legal/privacy-statement/" target="_self">Elastic’s Privacy Statement</a> for more details or to opt-out at any time.

Communication Preferences - ONLY for /communication-preferences

Durch das Absenden erklären Sie, dass Sie unsere <a href="/de/legal/elastic-cloud-account-terms" target="_self">Nutzungsbedingungen</a> gelesen haben und mit ihnen einverstanden sind und dass Sie Elastic erlauben, <a href="/de/legal/privacy-statement#how-we-use-the-information" target="_self">ausgewählte Nachrichten und Informationen</a> an die oben von Ihnen bereitgestellten Kontaktangaben zu senden. Weitere Informationen, darunter auch dazu, wie Sie Ihre Einwilligung zurückziehen können, finden Sie in der <a href="/de/legal/privacy-statement/" target="_self">Datenschutzerklärung von Elastic</a>.

By submitting you acknowledge that you've read and agree to our <a href="/legal/serverless-preview-terms" target="_blank">Terms of Service</a>, and that Elastic may <a href="/legal/privacy-statement#how-we-use-the-information" target="_blank">contact you</a> about our related products and services, using the details you provide above. See <a href="/legal/privacy-statement/" target="_blank">Elastic’s Privacy Statement</a> for more details or to opt-out at any time.

Serverless GDPR Text

Durch das Absenden erklären Sie, dass Sie unsere <a href="/de/legal/serverless-preview-terms" target="_self">Nutzungsbedingungen</a> gelesen haben und mit ihnen einverstanden sind und dass Sie Elastic erlauben, bezüglich unserer zugehörigen Produkte und Dienstleistungen und unter Nutzung der von Ihnen oben bereitgestellten Kontaktangaben <a href="/de/legal/privacy-statement#how-we-use-the-information" target="_self">mit Ihnen in Kontakt zu treten</a>. Weitere Informationen, darunter auch dazu, wie Sie Ihre Einwilligung zurückziehen können, finden Sie in der <a href="/de/legal/privacy-statement/" target="_self">Datenschutzerklärung von Elastic</a>.

By submitting you agree to <a href="/agreements/global/cloud-services-monthly" rel="nofollow">Elastic Cloud Terms of Service</a>. Your personal data will be processed in accordance with <a href="/legal/privacy-statement">Elastic's Privacy Statement</a>.

Cloud Trial GDPR Text

Beim Absenden akzeptieren Sie die <a href="/de/agreements/global/cloud-services-monthly" rel="nofollow">Nutzungsbedingungen von Elastic Cloud</a>. Die Verarbeitung Ihrer personenbezogenen Daten unterliegt der <a href="/de/legal/privacy-statement">Datenschutzerklärung von Elastic</a>.

By submitting you acknowledge that you've read and agree to our <a href="/legal/terms-of-use" target="_blank">Terms of Service</a>, and that Elastic may <a href="/legal/privacy-statement#how-we-use-the-information" target="_blank">contact you</a> about our related products and services, using the details you provide above. See <a href="/legal/privacy-statement/" target="_blank">Elastic’s Privacy Statement</a> for more details or to opt-out at any time.

Newsletter GDPR Text

Durch das Absenden erklären Sie, dass Sie unsere <a href="/de/legal/terms-of-use" target="_self">Nutzungsbedingungen</a> gelesen haben und mit ihnen einverstanden sind und dass Sie Elastic erlauben, bezüglich unserer zugehörigen Produkte und Dienstleistungen und unter Nutzung der von Ihnen oben bereitgestellten Kontaktangaben <a href="/de/legal/privacy-statement#how-we-use-the-information" target="_self">mit Ihnen in Kontakt zu treten</a>. Weitere Informationen, darunter auch dazu, wie Sie Ihre Einwilligung zurückziehen können, finden Sie in der <a href="/de/legal/privacy-statement/" target="_self">Datenschutzerklärung von Elastic</a>.

Explore similar demos

Overview

Speakers

Close

See more insights

The content on this page is not available in the selected language. As Elastic grows globally, we continue to support content in multiple languages.

The content on this page is not available in the selected language.

Der Inhalt dieser Seite ist in der ausgewählten Sprache nicht verfügbar. Wir bei Elastic arbeiten daran, die bereitgestellten Inhalte in verschiedenen Sprachen anzubieten. Bis dahin bitten wir Sie um etwas Geduld und hoffen auf Ihr Verständnis!

Author

Watch now (no PT)

Watch now

See all top stories

All (no PT translation)

Contact information

Press Release

Share on Reddit

Articles by

Share this story

Share by Email

Thank you for your interest!

Contact Info

Follow us on Youtube

Load More

Share on LinkedIn

Follow us on LinkedIn

Search Integrations

All Solutions

Video for

Follow us on Twitter

See when this webinar starts in my time zone

Register to Watch

Register now

See All Posts

Can't make it? Register and we'll send you the recording. You'll also receive an email with related content

Sie können nicht dabei sein? Registrieren Sie sich, damit wir Ihnen die Aufzeichnung zukommen lassen können. Außerdem erhalten Sie eine E‑Mail mit Begleitmaterial.

Small image for

On-demand webinar

Featured webinar

Register to Attend

Share on Facebook

Reset all

Upcoming webinar

View more posts

Print

Hosted by

Sign In to Attend

View next

Follow us on Facebook

Share

Highlights

Learn More

Read less

You'll also receive an email with related content

Wir schicken Ihnen zudem relevante Informationen, die von Interesse sein könnten.

Thank you for registering. We will send you a confirmation email soon.

Vielen Dank für Ihre Registrierung. Sie erhalten in Kürze eine Bestätigungs-E‑Mail von uns.

Author

Articles by Jongmin Kim

Community Advocate, Elastic

Systemüberwachung mit Metricbeat und Elastic Cloud

Baue deinen eigenen Beat