https://github.com/ruflin/elasticon2017beat
https://github.com/ruflin/elasticon2017beat
Last synced: 7 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/ruflin/elasticon2017beat
- Owner: ruflin
- License: other
- Created: 2017-03-02T14:26:31.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-03-08T18:08:35.000Z (over 8 years ago)
- Last Synced: 2025-01-23T16:54:02.170Z (8 months ago)
- Language: Go
- Size: 21.5 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# elasticon2017beat
elasticon2017beat is a beat based on metricbeat which was generated with metricbeat/metricset generator.
## Getting started
To get started run the following command. This command should only be run once.
```
make setup
```
It will ask you for the module and metricset name. Insert the name accordingly.
To compile your beat run `make`. Then you can run the following command to see the first output:
```
elasticon2017beat -e -d "*"
```
In case further modules are metricsets should be added, run:
```
make create-metricset
```
After updates to the fields or config files, always run
```
make collect
```
This updates all fields and docs with the most recent changes.
## Use vendoring
We recommend to use vendoring for your beat. This means the dependencies are put into your beat folder. The beats team currently uses [glide](https://github.com/Masterminds/glide) for vendoring.
```
glide init
glide update --quick
```
This will create a directory `vendor` inside your repository. To make sure all dependencies for the Makefile commands are loaded from the vendor directory, find the following line in your Makefile:
```
ES_BEATS=${GOPATH}/src/github.com/elastic/beats
```
Replace it with:
```
ES_BEATS=./vendor/github.com/elastic/beats
```
## Versioning
We recommend to version your repository with git and make it available on Github so others can also use your project. The initialise the git repository and add the first commits, you can use the following commands:
```
git init
git add README.md CONTRIBUTING.md
git commit -m "Initial commit"
git add LICENSE
git commit -m "Add the LICENSE"
git add .gitignore
git commit -m "Add git settings"
git add .
git reset -- .travis.yml
git commit -m "Add elasticon2017beat"
```
## Packaging
The beat frameworks provides tools to crosscompile and package your beat for different platforms. This requires [docker](https://www.docker.com/) and vendoring as described above. To build packages of your beat, run the following command:
```
make package
```
This will fetch and create all images required for the build process. The hole process to finish can take several minutes.