Skip to content

elastic/beats

Folders and files

NameName
Last commit message
Last commit date
Jun 15, 2023
Aug 28, 2023
Aug 31, 2023
Sep 4, 2023
Aug 16, 2023
Aug 17, 2023
Aug 31, 2023
Jun 15, 2023
Sep 6, 2023
Aug 31, 2023
Sep 5, 2023
Nov 4, 2021
Aug 21, 2023
Aug 4, 2023
Nov 29, 2022
Aug 29, 2023
Mar 22, 2022
Sep 5, 2023
Sep 6, 2023
Mar 24, 2020
Jan 11, 2019
Sep 1, 2022
Aug 4, 2023
Aug 31, 2023
Aug 16, 2023
May 31, 2023
Mar 24, 2017
Jul 13, 2022
Mar 22, 2022
Aug 28, 2023
Sep 5, 2023
Sep 6, 2023
May 31, 2017
Aug 31, 2023
Aug 24, 2022
Aug 29, 2019
Dec 29, 2022
Aug 29, 2023
Apr 27, 2022
Jul 28, 2023
Jun 15, 2023
Apr 6, 2017
Aug 29, 2023
Aug 29, 2023
Jun 22, 2023
Jun 29, 2020
Jan 31, 2023
Apr 13, 2017
May 29, 2017

Repository files navigation

Build Status Go Report Card Reviewed by Hound

Beats - The Lightweight Shippers of the Elastic Stack

The Beats are lightweight data shippers, written in Go, that you install on your servers to capture all sorts of operational data (think of logs, metrics, or network packet data). The Beats send the operational data to Elasticsearch, either directly or via Logstash, so it can be visualized with Kibana.

By "lightweight", we mean that Beats have a small installation footprint, use limited system resources, and have no runtime dependencies.

This repository contains libbeat, our Go framework for creating Beats, and all the officially supported Beats:

Beat Description
Auditbeat Collect your Linux audit framework data and monitor the integrity of your files.
Filebeat Tails and ships log files
Functionbeat Read and ships events from serverless infrastructure.
Heartbeat Ping remote services for availability
Metricbeat Fetches sets of metrics from the operating system and services
Packetbeat Monitors the network and applications by sniffing packets
Winlogbeat Fetches and ships Windows Event logs
Osquerybeat Runs Osquery and manages interraction with it.

In addition to the above Beats, which are officially supported by Elastic, the community has created a set of other Beats that make use of libbeat but live outside of this Github repository. We maintain a list of community Beats here.

Documentation and Getting Started

You can find the documentation and getting started guides for each of the Beats on the elastic.co site:

Documentation and Getting Started information for the Elastic Agent

You can find the documentation and getting started guides for the Elastic Agent on the elastic.co site

Getting Help

If you need help or hit an issue, please start by opening a topic on our discuss forums. Please note that we reserve GitHub tickets for confirmed bugs and enhancement requests.

Downloads

You can download pre-compiled Beats binaries, as well as packages for the supported platforms, from this page.

Contributing

We'd love working with you! You can help make the Beats better in many ways: report issues, help us reproduce issues, fix bugs, add functionality, or even create your own Beat.

Please start by reading our CONTRIBUTING file.

Building Beats from the Source

See our CONTRIBUTING file for information about setting up your dev environment to build Beats from the source.

Snapshots

For testing purposes, we generate snapshot builds that you can find here. Please be aware that these are built on top of main and are not meant for production.

CI

PR Comments

It is possible to trigger some jobs by putting a comment on a GitHub PR. (This service is only available for users affiliated with Elastic and not for open-source contributors.)

  • beats
    • jenkins run the tests please or jenkins run tests or /test will kick off a default build.
    • /test macos will kick off a default build with also the macos stages.
    • /test <beat-name> will kick off the default build for the given PR in addition to the <beat-name> build itself.
    • /test <beat-name> for macos will kick off a default build with also the macos stage for the <beat-name>.
  • apm-beats-update
    • /run apm-beats-update
  • apm-beats-packaging
    • /package or /packaging will kick of a build to generate the packages for beats.
  • apm-beats-tester
    • /beats-tester will kick of a build to validate the generated packages.

PR Labels

It's possible to configure the build on a GitHub PR by labelling the PR with the below labels

  • <beat-name> to force the following builds to run the stages for the <beat-name>
  • macOS to force the following builds to run the macos stages.