Skip to content

Meteor is an easy-to-use, plugin-driven metadata collection framework to extract data from different sources and sink to any data catalog.

License

Notifications You must be signed in to change notification settings

raystack/meteor

Repository files navigation

Meteor

test workflow build workflow Go Report Card Coverage Status Version License

Meteor is a plugin driven agent for collecting metadata. Meteor has plugins to source metadata from a variety of data stores, services and message queues. It also has sink plugins to send metadata to variety of third party APIs and catalog services.

Key Features

  • No Dependency: Written in Go. It compiles into a single binary with no external dependency.
  • Extensible: Plugin system allows new sources and sinks to be easily added.
  • Ecosystem: Extract metadata for many popular services with a wide number of service plugins.
  • Customizable: Add your own processors and sinks to suit your many use cases.
  • Runtime: Meteor can run inside VMs or containers with minimal memory footprint.

Documentation

Explore the following resources to get started with Meteor:

  • Usage Guides will help you get started on Meteor.
  • Concepts describes all important Meteor concepts.
  • Contribute contains resources for anyone who wants to contribute to Meteor.

Installation

Install Meteor on macOS, Windows, Linux, OpenBSD, FreeBSD, and on any machine.

Binary (Cross-platform)

Download the appropriate version for your platform from releases page. Once downloaded, the binary can be run from anywhere. You don’t need to install it into a global location. This works well for shared hosts and other systems where you don’t have a privileged account. Ideally, you should install it somewhere in your PATH for easy use. /usr/local/bin is the most probable location.

Homebrew

# Install meteor (requires homebrew installed)
$ brew install raystack/tap/meteor

# Upgrade meteor (requires homebrew installed)
$ brew upgrade meteor

# Check for installed meteor version
$ meteor version

Usage

Meteor’s CLI is fully featured but simple to use, even for those who have very limited experience working from the command line. Run meteor --help to see list of all available commands and instructions to use.

# List of commands
$ meteor --help

# Print command reference
$ meteor reference

Running locally

# Clone the repo
$ git clone https://github.com/raystack/meteor.git

# Install all the golang dependencies
$ go mod tidy

# Build meteor binary file
$ make build

# Run meteor on a recipe file
$ ./meteor run sample-recipe.yaml

# Run meteor on multiple recipes in a directory
$ ./meteor run directory-path

Running tests

# Running all unit tests, excluding extractors
$ make test

# Run integration test for any extractor
$ cd plugins/extractors/<name-of-extractor>
$ go test -tags=integration

Contribute

Development of Meteor happens in the open on GitHub, and we are grateful to the community for contributing bugfixes and improvements. Read below to learn how you can take part in improving Meteor.

Read our contributing guide to learn about our development process, how to propose bugfixes and improvements, and how to build and test your changes to Meteor.

To help you get your feet wet and get you familiar with our contribution process, we have a list of good first issues that contain bugs which have a relatively limited scope. This is a great place to get started.

This project exists thanks to all the contributors.

License

Meteor is Apache 2.0 licensed.