Créez des clusters Elasticsearch sur Elastic Cloud, ajoutez des utilisateurs avec X-Pack, créez des dashboards Kibana et chargez vos données avec Metricbeat.

<html><head></head><body>Elastic Cloud est l&apos;offre officielle h&#xE9;berg&#xE9;e d&apos;Elasticsearch et Kibana, &#xE9;labor&#xE9;e par les cr&#xE9;ateurs d&apos;Elasticsearch, Kibana, Beats et Logstash. Attention: &#xE0; ne pas confondre avec Amazon AWS Elasticsearch qui n&apos;est absolument pas la m&#xEA;me offre compl&#xE8;te. Pour plus de d&#xE9;tails, lisez cet <a href="/fr/blog/hosted-elasticsearch-services-roundup-elastic-cloud-and-amazon-elasticsearch-service">article</a>.
Elastic Cloud offre une version d&apos;essai valable 14 jours. Pour l&apos;obtenir, vous n&apos;avez pas besoin de renseigner vos donn&#xE9;es de facturation, une simple adresse e-mail suffit&#xA0;!
Dans cet article, nous d&#xE9;taillerons comment&#xA0;:
<ul>
	<li>Cr&#xE9;er un cluster Elasticsearch sur Elastic Cloud</li>
	<li>Ajouter un nouvel utilisateur avec X-Pack Security</li>
	<li>Utiliser Metricbeat pour rassembler les statistiques du syst&#xE8;me, les envoyer &#xE0; un cluster Elasticsearch fonctionnant sur Elastic Cloud et les visualiser dans un tableau de bord Kibana automatiquement charg&#xE9; par Metricbeat.</li>
</ul><h2>1. Cr&#xE9;er un compte Elastic Cloud</h2>Allez sur la page Elastic Cloud et enregistrez-vous pour un&#xA0;<a href="https://www.elastic.co/fr/cloud/as-a-service/signup">essai gratuit sur Elastic Cloud</a>. Remarque : passez directement &#xE0; l&apos;&#xE9;tape 2 si vous poss&#xE9;dez d&#xE9;j&#xE0; un compte Elastic Cloud.&#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">
Saisissez votre adresse e-mail et cliquez sur&#xA0;Start Free Trial. Vous allez recevoir un e-mail de v&#xE9;rification. Cliquez sur&#xA0;Verify Email and Accept TOS&#xA0;pour continuer.&#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;
D&#xE9;finissez le mot de passe de votre compte Elastic Cloud.
<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. Lancer un cluster Elasticsearch et une instance Kibana </h2>Une fois le mot de passe cr&#xE9;&#xE9;, vous serez automatiquement dirig&#xE9; vers l&apos;interface utilisateur d&apos;Elastic Cloud. Vous pourrez revenir en arri&#xE8;re plus tard en cliquant sur <a href="https://cloud.elastic.co">https://cloud.elastic.co</a>. 
Cliquez sur&#xA0;Create Cluster&#xA0;pour cr&#xE9;er votre premier cluster. 
<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">
S&#xE9;lectionnez la taille et la r&#xE9;gion du cluster, puis cliquez sur&#xA0;Create pour cr&#xE9;er&#xA0;votre cluster Elasticsearch. 
<img src="https://api.contentstack.io/v2/uploads/599b4376d9dcd8a66464d858/download?uid=bltd526aa6fcf9781be" data-sys-asset-uid="bltd526aa6fcf9781be" alt="Elastic_Cloud.png">
Une fois votre cluster Elasticsearch cr&#xE9;&#xE9;, le mot de passe g&#xE9;n&#xE9;r&#xE9; pour le super-utilisateur&#xA0;elastic, s&#x2019;affichera. Vous ne pourrez plus revoir ce mot de passe par la suite, alors copiez-le et rangez-le en lieu s&#xFB;r.&#xA0;
<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;
Si vous l&apos;oubliez, vous pourrez le red&#xE9;finir dans le menu Security de la console Elastic Cloud.
<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">
Allez dans le menu&#xA0;Overview. Les URL d&apos;acc&#xE8;s d&apos;Elasticsearch et de Kibana y sont affich&#xE9;es. 
<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. Cr&#xE9;er un nouveau super-utilisateur</h2>Cliquez sur l&apos;URL Kibana qui vous dirigera vers la page de connexion de Kibana. Tapez &#xAB; elastic &#xBB; pour l&apos;utilisateur ainsi que le mot de passe g&#xE9;n&#xE9;r&#xE9; automatiquement (celui que vous avez rang&#xE9; en lieu s&#xFB;r) pour vous connecter.
<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 int&#xE8;gre plusieurs fonctionnalit&#xE9;s de X-Pack, comme la Security et Monitoring. 
Si vous pr&#xE9;f&#xE9;rez choisir un nom d&apos;utilisateur ou un mot de passe plus &#xE9;vocateur, vous avez la possibilit&#xE9; de cr&#xE9;er un nouveau super-utilisateur &#xE0; l&apos;aide de la fonctionnalit&#xE9; Role Based Access Control. Allez sur l&apos;onglet Management, puis s&#xE9;lectionnez&#xA0;Users&#xA0;dans la partie Security&#xA0;: 
<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;
Cliquez sur le bouton&#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;
Saisissez le nom d&apos;utilisateur, le mot de passe, l&apos;identit&#xE9;, l&apos;e-mail, puis&#xA0;superuser&#xA0;pour le r&#xF4;le, et enregistrez. 
<img src="https://api.contentstack.io/v2/uploads/5996768427ab71de2fb9039b/download?uid=blt4c0fbc3a6b8eaf4f" data-sys-asset-uid="blt4c0fbc3a6b8eaf4f" alt="new_user_reg.png"> 
Votre nouveau compte super-utilisateur sera ainsi cr&#xE9;&#xE9;. 
<img src="https://api.contentstack.io/v2/uploads/599676b88f6b4d840686a697/download?uid=blt5c92f591326dce96" data-sys-asset-uid="blt5c92f591326dce96" alt="new_user_registered.png"> 
D&#xE9;connectez-vous puis reconnectez-vous &#xE0; l&apos;aide de votre nouveau compte pour v&#xE9;rifier que tout fonctionne.&#xA0;
<img src="https://api.contentstack.io/v2/uploads/59967720b3ba08942fce2cba/download?uid=blt8ae76430e0e3afc9" data-sys-asset-uid="blt8ae76430e0e3afc9" alt="new_login.png"> 
<h2>4. Configurer et lancer Metricbeat </h2>Maintenant qu&apos;Elasticsearch et Kibana sont configur&#xE9;s, il est grand temps d&apos;envoyer des donn&#xE9;es. Dans ce tutoriel,&#xA0;<a href="https://www.elastic.co/fr/products/beats/metricbeat" target="_blank">Metricbeat</a>&#xA0;sera utilis&#xE9; &#xE0; ces fins.&#xA0;
Metricbeat recueille toute sorte de statistiques dans votre syst&#xE8;me et les envoie &#xE0; votre instance Elasticsearch ou Logstash. Il s&#x2019;ex&#xE9;cute en tant que fichier binaire ; il faudra donc t&#xE9;l&#xE9;charger le fichier correspondant &#xE0; votre syst&#xE8;me d&apos;exploitation. Allez sur la <a href="https://www.elastic.co/downloads/beats/metricbeat">page de t&#xE9;l&#xE9;chargement Metricbeat</a>, t&#xE9;l&#xE9;chargez le fichier correspondant &#xE0; votre syst&#xE8;me d&apos;exploitation et d&#xE9;compressez-le.
<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;
Vous verrez plusieurs fichiers appara&#xEE;tre dans le r&#xE9;pertoire metricbeat.
<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;
Le fichier&#xA0;metricbeat&#xA0;(ou&#xA0;metricbeat.exe&#xA0;pour Windows OS)&#xA0;ex&#xE9;cutera Metricbeat. Par d&#xE9;faut, les donn&#xE9;es sont envoy&#xE9;es &#xE0; Elasticsearch sur l&apos;adress&#xA0;http://localhost:9200. Vous devrez donc modifier la configuration pour pouvoir les envoyer vers&#xA0;votre cluster Elastic Cloud.&#xA0;
Ouvrez&#xA0;metricbeat.yml&#xA0;avec votre &#xE9;diteur de code favori.
<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">
Replacez&#xA0;<code style="font-size: 12.6px;">&quot;localhost:9200&quot;</code>&#xA0;par l&apos;URL du nouveau cluster Elasticsearch.&#xA0; 
<pre style="font-size: 12.600000381469727px;">output.elasticsearch:
 #Array of hosts to connect to.
 hosts: [&quot;localhost:9200&quot;]
</pre>Tapez vos nouveaux nom d&apos;utilisateur et mot de passe (si vous avez saut&#xE9; l&apos;&#xE9;tape de la cr&#xE9;ation d&apos;utilisateur, vous pouvez utiliser &#xAB; elastic &#xBB; et le mot de passe g&#xE9;n&#xE9;r&#xE9; automatiquement).
<pre style="font-size: 12.600000381469727px;"> username: &quot;&lt;user id&gt;&quot; 
 password: &quot;&lt;password&gt;&quot;
</pre>Faites bien attention &#xE0; la grammaire yaml ; vous devez laisser le bon espacement entre chaque ligne. &#xAB; username: &#xBB; et &#xAB; password: &#xBB; doivent comporter un alin&#xE9;a de 2 espaces contrairement au reste du texte qui ne commence par aucun espace. 
Enregistrez le fichier metricbeat.yml. Ensuite, lancez metricbeat avec l&apos;option -setup, afin de demander au syst&#xE8;me de charger les tableaux de bord des statistiques par d&#xE9;faut sur Kibana.
<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">
ASTUCE : Si vous ajoutez l&apos;option&#xA0;-e&#xA0;lors du lancement de Metricbeat, les logs s&apos;afficheront pendant le fonctionnement.<h2>5. V&#xE9;rifier les tableaux de bord Metricbeat</h2>Nous avons ajout&#xE9; l&apos;option -setup&#xA0;lors du lancement de Metricbeat de fa&#xE7;on &#xE0; charger automatiquement les tableaux de bord Metricbeat et ses visualisations dans Kibana : 
<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;
Cliquez sur le menu Dashboard dans Kibana pour afficher les tableaux de bord de Metricbeat. V&#xE9;rifiez que les statistiques de votre syst&#xE8;me sont bien envoy&#xE9;es &#xE0; Elasticsearch :
<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;
Maintenant que vous avez vu comment cela fonctionne, vous pouvez d&#xE9;ployer Metricbeat sur d&apos;autres syst&#xE8;mes. Lancez-vous !
</body></html>

blog-metricbeat-fb.jpg

blog-metricbeat-thumb.jpg

Monitor Your System with Metricbeat and Elastic Cloud

Monitorez votre système avec Metricbeat et Elastic Cloud

Apprenez comment créer votre propre Beat à partir de rien en utilisant Lsbeat comme exemple.

Beats est une plateforme permettant de mettre en place des outils de transport léger pour les données open source. Elle envoie ainsi à Elasticsearch toutes sortes de données qui seront analysées ultérieurement. Notre service comprend Packetbeat pour surveiller le trafic réseau échangé entre vos serveurs, Filebeat pour obtenir les logs de vos serveurs, et le tout nouveau Metricbeat qui récupère à intervalles réguliers des indicateurs provenant de systèmes externes. Si vous avez besoin de collecter d'autres données personnalisées, vous pouvez facilement développer votre propre Beat dans l'environnement libbeat. Nous comptons déjà plus de 25 <a href="https://www.elastic.co/guide/en/beats/libbeat/current/community-beats.html">Beats</a> créées par la communauté.
Nous vous fournissons le pack Générateur de Beat (Beat Generator) qui vous aide à créer votre propre Beat. Dans cet article, vous verrez comment créer votre propre Beat au moyen de ce générateur. Le Beat que nous allons créer aujourd'hui pour nous entraîner s'appelle&nbsp;<a href="https://github.com/kimjmin/lsbeat">lsbeat</a>. lsbeat indexe des informations de fichiers et de répertoires, comme la commande Unix <code>ls</code>.&nbsp;Cet article est fait pour Unix, donc si vous êtes sur Windows ou tout autre système d'exploitation (OS), suivez les instructions qui correspondent à votre OS. 
<h2>Étape 1 :&nbsp;Installation de l'environnement Golang</h2> Les Beats sont écrits en Golang. Pour créer et développer un Beat, il faut que Golang soit installé sur votre machine. Suivez ce guide pour <a href="https://golang.org/doc/install">installer Golang</a>. Actuellement, Beats nécessite au moins Golang 1.6. Assurez-vous d'avoir configuré votre variable <code>$GOPATH</code>.
Voyons ensemble le code que nous allons utiliser pour Lsbeat. Il s'agit d'un simple programme Golang qui reçoit un répertoire en argument de ligne de commande et qui liste l'ensemble des fichiers et sous-répertoires contenus dans le répertoire. 
<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>Nous réutiliserons le code de la fonction <code>listDir</code>. 
<h2>Étape 2 :&nbsp;Génération</h2> Afin de générer notre propre Beat, nous utilisons le <a href="https://github.com/elastic/beats/tree/master/generator/beat">Beat Generator</a>. Vous devez d'abord installer&nbsp;<a href="https://github.com/audreyr/cookiecutter">cookiecutter</a>&nbsp;: consulter le guide d'installation <a href="http://cookiecutter.readthedocs.org/en/latest/installation.html">ici</a>. Une fois cookiecutter installé, nous devons nommer le Beat. Le nom doit être constitué d'un seul mot entièrement en minuscules. Dans cet exemple, nous utilisons <code>lsbeat</code>.
Afin de créer le squelette du Beat, vous devez vous procurer le pack générateur de Beats, disponible sur le répertoire de <a href="https://github.com/elastic/beats">Beats</a>. Une fois&nbsp;<a href="https://golang.org/dl/">Golang</a>&nbsp;installé, vous pouvez télécharger le Beat Generator&nbsp;à l'aide de la commande <code>go get</code>.&nbsp;Une fois la commande exécutée, tous les fichiers sources seront téléchargés dans <code>$GOPATH/src</code>.
<pre class="prettyprint">$ go get github.com/elastic/beats
</pre>Pour travailler sur une branche stable, récupérez cette branche spécifique.
<pre class="prettyprint" style="font-size: 12.6px;">$ cd $GOPATH/src/github.com/elastic/beats
$ git checkout 5.1
</pre>Maintenant, créez votre propre répertoire sous GOPATH, rendez-vous y puis exécutez cookiecutter avec le chemin d'accès du Beat Generator. 
<pre class="prettyprint">$ cd $GOPATH/src/github.com/{user}
$ cookiecutter $GOPATH/src/github.com/elastic/beats/generate/beat
</pre>Cookiecutter vous posera plusieurs questions. Pour project_name, entrez lsbeat ; pour github_name, votre nom d'utilisateur github. Les deux questions suivantes concernant beat et beat_path devraient déjà être remplies correctement. Pour la dernière, vous pouvez entrer votre prénom et votre nom.
<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>Désormais, un nouveau répertoire lsbeat devrait apparaître à l'intérieur de notre dossier et contenir plusieurs fichiers. Allons dans ce répertoire et listons les fichiers créés de façon automatique.
<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>Nous disposons à présent d'un modèle de base du Beat mais devons encore en récupérer les dépendances et configurer le répertoire Git.
Vous devez d'abord récupérer les dépendances, constituées seulement de libbeat dans notre cas, puis créer les fichiers de configuration et de modèle de base. Nous examinerons plus en détail les fichiers de configuration et de modèle plus tard.
<pre class="prettyprint">$ make setup
</pre>Une fois en possession de votre propre Beat, commencez à le partager avec la communauté en le transférant sur un dépôt GitHub.
<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">
Pour envoyer lsbeat sur le dépôt GitHub, exécutez les commandes suivantes :
<pre class="prettyprint">$ git remote add origin git@github.com:{username}/lsbeat.git
$ git push -u origin master
</pre>Nous possédons désormais un Beat complet et avons envoyé sa première version sur GitHub. Développons et exécutons notre Beat puis explorons le code plus en détail. 
<h2>Étape 3 :&nbsp;Configuration</h2> L'exécution des commandes ci-dessus crée les fichiers lsbeat.yml et lsbeat.template.json automatiquement. Ceux-ci contiennent déjà toutes les configurations de base.
lsbeat.yml:
<pre class="prettyprint">lsbeat:
 # Defines how often an event is sent to the output
 period: 1s
</pre><code>period</code> est un paramètre de durée inclut&nbsp;par le&nbsp;générateur dans chaque Beat. Il définit le fait que Lsbeat exécute le processus toutes les secondes. Modifions ce paramètre de durée (<code style="line-height: 1.6em;">period</code>) de 1 à 10 secondes et rajoutons un nouveau paramètre de chemin (<code style="line-height: 1.6em;">path</code>)&nbsp;qui représente le chemin du répertoire parent que le programme scannera. Nous pouvons ajouter ces paramètres dans beat.yml situé dans le répertoire etc/.&nbsp;
<pre class="prettyprint">lsbeat:
 # Defines how often an event is sent to the output
 period: 10s
 path: "."
</pre>Après avoir ajouté ces nouveaux paramètres, nous exécutons la commande <code>make update</code>&nbsp;pour appliquer les modifications faites au fichier de configuration lsbeat.yml. Nous pouvons voir que les nouveaux paramètres que nous avons définis dans etc/beat.yml sont maintenant disponibles dans lsbeat.yml.
<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>Après avoir mis à jour les fichiers de configuration, vous devez éditer config/config.go, de manière à pouvoir ajouter le paramètre&nbsp;<code>path</code>.
<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>Utilisons les options de configuration par défaut suivantes : 10 secondes pour la durée et répertoire courant (.) pour le répertoire par défaut. 
<h2>Étape 4 :&nbsp;Ajout de&nbsp;code</h2> Chaque Beat a besoin d'implémenter l'interface Beater, en définissant les fonctions <code>Run()</code> et <code>Stop()</code>. Un guide plus détaillé à propos de l'interface Beater est disponible&nbsp;<a href="https://www.elastic.co/guide/en/beats/libbeat/master/beater-interface.html" target="_blank">ici</a>.
Pour cela, il vous faut simplement définir une structure nommée <code>Lsbeat</code> qui définit l'objet Lsbeat chargé d'implémenter l'interface Beater. Puis ajoutons <code>lastIndexTime</code> que nous allons utiliser pour enregistrer les dernières données d'horodatage.
<pre class="prettyprint">type Lsbeat struct {
 done chan struct{}
 config config.Config
 client publisher.Client
 lastIndexTime time.Time
}
</pre>De plus, chaque Beat a besoin d'implémenter la fonction <code>New()</code>, qui reçoit les données de configuration du Beat et renvoie l'objet Beat au format Lsbeat.
<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>Dans le cas de Lsbeat, nous souhaitons étendre la fonction <code>Run()</code> par défaut afin d'exporter des informations à propos des fichiers et sous-répertoires présents dans un répertoire..
Avant de modifier la fonction <code>Run()</code>,&nbsp;ajoutons d'abord la fonction <code>listDir()</code> au bas du fichier lsbeat.go, qui collecte les informations sur les fichiers et les répertoires. Il génère des événements dont :
<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>Il indexera tous les noms des fichiers et répertoires la première fois, puis lors des routines suivantes, vérifiera si le fichier ou le répertoire a été créé ou modifié afin d'indexer seulement les nouveaux fichiers et répertoires. Les données d'horodatage de la dernière routine seront enregistrées dans la variable <code>lasIndexTime</code>.
<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>Et pensez à ajouter le pack <code>io/ioutil</code> aux bibliothèques d'importation.
<pre class="prettyprint">import (
 "fmt"
 "io/ioutil"
 "time"
)
</pre>Maintenant, occupons-nous de la fonction <code>Run()</code> qui appelle la fonction <code>listDir()</code> et enregistre les données d'horodatage dans la variable <code>lasIndexTime</code> .
<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>La fonction <code>Stop()</code> est censée interrompre la boucle d'exécution et il en est de même avec celle générée :
<pre class="prettyprint">func (bt *Lsbeat) Stop() {
 bt.client.Close()
 close(bt.done)
}
</pre>Nous avons presque fini avec le codage. Il nous faut ajouter de nouveaux champs dans le mapping. Ajoutez les informations des champs dans le fichier <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>Puis appliquez les nouvelles mises à jour.
<pre class="prettyprint">$ make update
</pre><code>filename</code> sera analysé avec le tokenizer nGram. Ajoutons un analyseur personnalisé au fichier lsbeat.template.json, en allant dans les paramètres (« settings »).
<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>Étape 5 :&nbsp;Compilation et exécution</h2> Nous pouvons maintenant passer à la compilation et à l'exécution. Exécutez simplement la commande make pour compiler le code et créer le fichier binaire exécutable&nbsp;<code>lsbeat</code> (<code>lsbeat.exe</code> sous Windows).
<pre class="prettyprint">$ make
</pre>Modifiez le fichier lsbeat.yml pour définir le répertoire racine et ainsi lister les fichiers. Dans notre cas, nous définirons $GOPATH pour&nbsp;<code>/Users/ec2-user/go</code>. Assurez-vous de bien entrer le chemin d'accès complet du répertoire.
<pre class="prettyprint">lsbeat:
 # Defines how often an event is sent to the output
 period: 10s
 path: "/Users/ec2-user/go"
</pre>Et assurez-vous également qu'Elasticsearch et Kibana soient lancés sur votre machine. Exécutons Lsbeat et voyons ce qu'il se passe.
<pre class="prettyprint">$ ./lsbeat
</pre>Vous pouvez utiliser l'api <code>_cat</code> pour vérifier si l'index a bien été créé et si les données sont correctement indexées. 
<img src="https://api.contentstack.io/v2/assets/5787f7b662ff8c94777fc33e/download?uid=blt47d7e8421c87b1b7" data-sys-asset-uid="blt47d7e8421c87b1b7" alt="cat.png">
 Nous pouvons voir l'index <code>lsbeat-2016.06.03</code> ainsi que le nombre de documents. Interrogeons Lsbeat à l'aide du champ <code>filename</code>, qui a été préalablement analysé avec le filtre <code>nGram</code>, en utilisant le mot clé <code>lsbe</code>. 
<img src="https://api.contentstack.io/v2/assets/5787f7cdc0bc38f452f81a2e/download?uid=blte53a76e132c239b6" data-sys-asset-uid="blte53a76e132c239b6" alt="query.png">
Eureka ! Félicitations, vous venez de développer votre propre Beat.

beats_full_width.png

beats_blog.png

Build your own Beat

Développez votre propre 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

En confirmant votre envoi, vous reconnaissez que vous avez lu et que vous acceptez nos <a href="/fr/legal/elastic-cloud-account-terms" target="_self">Conditions générales d'utilisation</a>, et vous acceptez de recevoir les <a href="/fr/legal/privacy-statement#how-we-use-the-information" target="_self">types de notification sélectionnés</a> à l'adresse que vous avez fournie plus haut. Pour en savoir plus ou pour revenir sur votre décision (possible à tout moment), consultez la <a href="/fr/legal/privacy-statement/" target="_self">Déclaration de confidentialité d'Elastic</a>.

By submitting you acknowledge that you've read and agree to our <a href="/legal/elastic-cloud-account-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.By submitting this form, I agree to Elastic sharing my contact information with Google Cloud. I also agree to Elastic giving my information to the vendor for the purpose of shipping my food package.

GDPR Text + Google Cloud

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

En confirmant votre envoi, vous reconnaissez que vous avez lu et que vous acceptez nos <a href="/fr/legal/serverless-preview-terms" target="_self">Conditions générales d'utilisation</a>, et vous permettez à Elastic de <a href="/fr/legal/privacy-statement#how-we-use-the-information" target="_self">vous contacter</a> à propos de produits et services similaires en utilisant les informations que vous avez fournies plus haut. Pour en savoir plus ou pour revenir sur votre décision (possible à tout moment), consultez la <a href="/fr/legal/privacy-statement/" target="_self">Déclaration de confidentialité d'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

En envoyant votre demande d'inscription, vous acceptez les <a href="/fr/agreements/global/cloud-services-monthly" rel="nofollow">conditions générales d'utilisation d'Elastic Cloud</a>. Vos données personnelles seront traitées conformément à la <a href="/fr/legal/privacy-statement">déclaration de confidentialité d'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

En confirmant votre envoi, vous reconnaissez que vous avez lu et que vous acceptez nos <a href="/fr/legal/terms-of-use" target="_self">Conditions générales d'utilisation</a>, et vous permettez à Elastic de <a href="/fr/legal/privacy-statement#how-we-use-the-information" target="_self">vous contacter</a> à propos de produits et services similaires en utilisant les informations que vous avez fournies plus haut. Pour en savoir plus ou pour revenir sur votre décision (possible à tout moment), consultez la <a href="/fr/legal/privacy-statement/" target="_self">Déclaration de confidentialité d'Elastic</a>.

Explore similar demos

Overview

You'll also receive an email with related content.

You'll also receive an email with related content

Nous vous enverrons plus de contenu susceptible de vous intéresser.

Speakers

Close

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.

Le contenu de cette page n'est pas disponible dans la langue sélectionnée. Chez Elastic, nous mettons tout en œuvre pour vous proposer du contenu dans différentes langues. En attendant, nous vous remercions de votre patience !

See more insights

Articles by

Author

Learn more

Watch now (no PT)

Watch now

See all top stories

All (no PT translation)

Contact information

Press Release

Share on Reddit

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

Voir à quelle heure débute le webinar dans mon fuseau horaire

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

Si vous ne pouvez pas vous libérer le jour J, inscrivez-vous et nous vous enverrons l'enregistrement. Vous recevrez aussi un e-mail contenant des ressources connexes.

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

Read less

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

Nous vous remercions de votre inscription. Vous allez recevoir un e-mail de confirmation.

Author

Articles by Jongmin Kim

Community Advocate, Elastic

Monitorez votre système avec Metricbeat et Elastic Cloud

Développez votre propre Beat