Alloy Modules

Modules are a way to create Grafana Alloy configurations which can be loaded as a component. Modules are a great way to parameterize a configuration to create reusable pipelines.

Submitting modules

Create a folder for the module under the ./modules directory in the appropriate category. Each module must have a README.md that provides the following information:

• Components
• Brief description
• Applicable Alloy versions
• Declare arguments and exports
• Example

Referencing Modules

Whenever a new module is submitted and a pull request is merged to the main branch, a tag is automatically created and published, by default this is a patch bump.

Modules can be reference directly from this git repository using the import.git or import.http components. It is recommended to always reference a tagged version, and not the main branch.