Skip to content

Info about restarting engine after updating a script used by a stream… #5238

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
cg-tw wants to merge 1 commit into
base: staging
Choose a base branch
from
+12 −16
Draft

Info about restarting engine after updating a script used by a stream… #5238

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 12 additions & 16 deletions ...aurus-plugin-content-docs/version-25.10/developer/developer-stream-connector.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,25 +21,21 @@ Cet output charge un script Lua appelé un Stream Connector, dont la tâche cons

Comme il s'agit d'un output de Centreon Broker, le principe de la création de fichiers de rétention lors de l'interruption de l'accès au stockage externe est conservé. De la même manière, il est possible de filtrer les entrées sur les catégories de flux à traiter.

## Prérequis
## Migration d'un Stream Connector de BBDO 2 vers BBDO 3

Pour utiliser la fonctionnalité Centreon Stream Connector, vous devez disposer au minimum de la version 3.4.6 de Centreon :
La documentation technique de la migration est disponible [ici](developer-broker-stream-connector-migration.md). Ce mode d'emploi donne plusieurs conseils pour réussir la migration et présente un petit exemple.

## Prérequis

* Centreon Web >= 2.8.18
* Centreon Broker >= 3.0.13
* Lua >= 5.1.x
Pour utiliser la fonctionnalité Centreon Stream Connector, vous devez utiliser Lua >= 5.1.x.

## Création d'un nouveau script Lua
## Présentation

La documentation technique complète est disponible [ici](developer-broker-stream-connector.md). Dans ce mode d'emploi, nous allons écrire deux scripts :
La documentation technique complète est disponible [ici](developer-broker-stream-connector.md). Dans cette page, nous allons écrire deux scripts :

* Le premier, simple, qui explique les bases des Stream Connectors. Son objectif est d'exporter les données vers un fichier journal.
* Le second est plus exigeant pour le lecteur, il exporte les données de performance vers la TSDB InfluxDB mais est facilement adaptable pour exporter vers une autre TSDB.

## Migration d'un Stream Connector de BBDO 2 vers BBDO 3

La documentation technique de la migration est disponible [ici](developer-broker-stream-connector-migration.md). Ce mode d'emploi donne plusieurs conseils pour réussir la migration et présente un petit exemple.

### Langage de programmation

Centreon a choisi le langage de programmation Lua pour vous permettre de manipuler, d'agréger et de transférer des données. Lua est un langage de programmation facile à utiliser. De plus amples informations sont disponibles avec la [Documentation officielle Lua](https://www.lua.org/docs.html).
Expand All @@ -50,9 +46,9 @@ Les scripts Lua de Broker peuvent être stockés dans tout répertoire lisible p

Nous recommandons de les stocker dans **/usr/share/centreon-broker/lua**.

### Écrire toutes les informations dans un fichier
## Exporter les données vers un fichier journal

#### Stocker les données brutes
### Stocker les données brutes

Commençons par le premier script. Notre objectif est de stocker tous les événements donnés par Broker dans un fichier journal. Nous allons appeler notre Stream Connector **bbdo2file.lua**.

Expand Down Expand Up @@ -201,7 +197,7 @@ mer. 28 mars 2018 14:27:35 CEST: INFO: last_hard_state => 0

> Ce fichier journal va grossir rapidement, n'oubliez pas d'ajouter une rotation du journal.

#### Utiliser les paramètres
### Utiliser les paramètres

Les fonctions de journalisation de Centreon Broker ne doivent être utilisées que pour la journalisation. Pour écrire dans un fichier, nous devons utiliser la fonction dédiée de Lua. En outre, il est possible d'utiliser des paramètres pour définir le nom du fichier journal.

Expand Down Expand Up @@ -288,7 +284,7 @@ is_for_rebuild => false
metric_id => 11920
```

#### Manipuler les données
### Manipuler les données

Ici, nous continuons à améliorer notre Stream Connector en choisissant les événements à exporter et aussi en améliorant les outputs.

Expand Down Expand Up @@ -739,4 +735,4 @@ Si vous installez le tableau de bord [Grafana](https://grafana.com/), vous pouve

Centreon fournit un dépôt Github pour héberger les scripts Lua développés par Centreon et la communauté. Rendez-vous sur le [Github dédié](http://github.com/centreon/centreon-stream-connector-scripts).

Vous avez besoin d'aide pour développer votre Stream Connector ? Vous voulez partager votre expérience avec la communauté ? Rejoignez notre [plateforme communautaire The Watch](https://thewatch.centreon.com/).
Vous avez besoin d'aide pour développer votre Stream Connector ? Vous voulez partager votre expérience avec la communauté ? Rejoignez notre [plateforme communautaire The Watch](https://thewatch.centreon.com/).
Loading