protologbeat
Version 0.2.0
Cette application est destinée à remplacer udplogbeat. Bien qu'assez similaire, il présente quelques améliorations et permet de démarrer via UDP ou TCP. Il peut accepter les journaux en texte brut ou JSON et également servir de remplacement de destination Syslog.
Assurez-vous que ce dossier se trouve à l'emplacement suivant : ${GOPATH}/github.com/harfordfive
protologbeat.protocol : Soit TCP , soit UDP (par défaut : udp)protologbeat.address : L'adresse sur laquelle le processus va écouter (par défaut : 127.0.0.1)protologbeat.port : Le port sur lequel le processus écoutera (par défaut = 5000)protologbeat.max_message_size : La taille maximale acceptée du message (par défaut = 4096)protologbeat.json_mode : Activer la journalisation des messages au format JSON uniquement (par défaut = false)protolog.merge_fields_to_root : lorsque json_mode est activé, s'il faut fusionner les champs analysés au niveau racine. (Par défaut = faux)protologbeat.default_es_log_type : type Elasticsearch à attribuer à un événement si aucun n'est spécifié (par défaut : protologbeat)protologbeat.enable_syslog_format_only : valeur booléenne indiquant si seuls les messages syslog doivent être acceptés. (Par défaut = faux)protologbeat.enable_gelf : valeur booléenne indiquant si le processus doit être en mode pour accepter uniquement les messages au format GELFprotologbeat.enable_json_validation : valeur booléenne indiquant si la validation du schéma JSON doit être appliquée pour les messages au format json (par défaut = false)protologbeat.validate_all_json_types : Lorsque json_mode est activé, indique si TOUS les types doivent avoir un schéma spécifié. Les entrées de journal dont les types n'ont pas de schéma ne seront pas publiées. (Par défaut = faux)protologbeat.json_schema : un hachage composé du type Elasticsearch comme clé et du chemin absolu du fichier de schéma local comme valeur. Voici des exemples de blocs de configuration pour la section protologbeat .
Les schémas JSON peuvent être générés automatiquement à partir d'un objet ici : http://jsonschema.net/. Vous pouvez également afficher les schémas email_contact et stock_item à titre d'exemples.
Veuillez consulter le répertoire _samples/ pour des exemples de clients dans différentes langues.
Pour démarrer avec Protologbeat et également installer les dépendances, exécutez la commande suivante :
make setup
Cela créera un historique git propre pour chaque étape majeure. Notez que vous pouvez toujours réécrire l'historique si vous le souhaitez avant de pousser vos modifications.
Pour pousser Protologbeat dans le référentiel git, exécutez les commandes suivantes :
git remote set-url origin https://github.com/harfordfive/protologbeat
git push origin master
Pour un développement ultérieur, consultez le guide du développeur Beat.
Pour créer le binaire pour Protologbeat, exécutez la commande ci-dessous. Cela générera un binaire dans le même répertoire avec le nom protologbeat.
make
Si vous souhaitez créer le binaire pour OSX, Linux et/ou Windows, vous pouvez exécuter ce qui suit :
./build-bin [TAG_VERSION]
Les binaires résultants seront placés dans le répertoire bin/
Pour exécuter Protologbeat avec la sortie de débogage activée, exécutez :
./protologbeat -c protologbeat.yml -e -d "*"
Pour tester Protologbeat, exécutez la commande suivante :
make testsuite
alternativement :
make unit-tests
make system-tests
make integration-tests
make coverage-report
La couverture des tests est rapportée dans le dossier ./build/coverage/
Chaque battement a un modèle pour le mappage dans elasticsearch et une documentation pour les champs qui est automatiquement générée sur la base de etc/fields.yml . Pour générer etc/protologbeat.template.json et etc/protologbeat.asciidoc
make update
Pour nettoyer le code source de Protologbeat, exécutez les commandes suivantes :
make fmt
make simplify
Pour nettoyer le répertoire de build et les artefacts générés, exécutez :
make clean
Pour cloner Protologbeat depuis le dépôt git, exécutez les commandes suivantes :
mkdir -p ${GOPATH}/github.com/harfordfive
cd ${GOPATH}/github.com/harfordfive
git clone https://github.com/harfordfive/protologbeat
Pour un développement ultérieur, consultez le guide du développeur Beat.
Vous pouvez trouver les images Docker pour ce rythme ici. Veuillez noter que le conteneur démarre avec une configuration de base qui écoute le protocole/l'adresse/le port par défaut et accepte les messages en texte brut. Pour toute personnalisation, veuillez modifier l'exemple de configuration protologbeat.full.yml et créer votre propre fichier Docker qui écrase l'original.
Les frameworks beat fournissent des outils pour compiler et empaqueter votre rythme pour différentes plates-formes. Cela nécessite Docker et Vending comme décrit ci-dessus. Pour créer des packages de votre rythme, exécutez la commande suivante :
make package
Cela récupérera et créera toutes les images requises pour le processus de construction. Le processus de perçage peut prendre plusieurs minutes.
