---
description: Start here to build, test, and contribute MetricsHub community connectors. Includes the official connector developer guide and generated connector reference pages.
date_published: 2026-08-13
date_modified: 2026-08-13
canonical_url: https://metricshub.org/community-connectors/index.html
---

# MetricsHub Community Connectors

On this Page

- [Who This Site Is For](#who-this-site-is-for)
- [What You Will Find Here](#what-you-will-find-here)
- [Recommended Learning Path](#recommended-learning-path)
- [Repository Layout (Developer View)](#repository-layout-developer-view)
- [Contribution Workflow (High Level)](#contribution-workflow-high-level)
- [External Links](#external-links)

This repository contains **MetricsHub community connectors** and their documentation. It is the entry point for developers who want to:

- create a new connector
- improve an existing connector
- learn the connector model used by MetricsHub

> **Important**
>
> The **official implementation guide** is the [Connector Developer Guide](develop/quick-start.html). Use it as the single source of truth for connector structure, detection, sources, computes, mapping, and testing.

## Who This Site Is For

- Developers adding monitoring support for new platforms
- Contributors maintaining existing connectors
- Reviewers validating connector quality, consistency, and compatibility

## What You Will Find Here

- A complete developer guide in `develop/...`
- Generated library views: 
  
    - [Supported Platforms](supported-platforms.html)
    - [Connectors Directory](connectors-directory.html)

## Recommended Learning Path

If you are new to connector development, read in this order:

1. [Quick Start](develop/quick-start.html)
2. [Connector Structure](develop/connector-structure.html)
3. [Monitors and Jobs](develop/monitors-and-jobs.html)
4. [Reuse and Configuration](develop/reuse-and-configuration.html)
5. [References and Expressions](develop/references-and-expressions.html)
6. [Design Principles](develop/design-principles.html)
7. [Detection](develop/detection/index.html)
8. [Sources](develop/sources/index.html)
9. [Computes](develop/computes/index.html)
10. [Mapping, Metrics, and Semconv](develop/mapping-metrics-semconv.html)
11. [Metric and Attribute Naming](develop/metric-naming.html)
12. [Run and Debug Locally](develop/run-and-debug.html)
13. [Integration Testing](develop/integration-testing.html)
14. [Contributing](develop/contributing.html)
15. [Legacy and Compatibility](develop/legacy-and-compatibility.html)

## Repository Layout (Developer View)

```text
src/main/connector/           Connector YAML files and embedded scripts/files
src/site/markdown/            Documentation source (this site)
src/it/resources/             Replay integration test resources
src/it/java/                  Replay integration test code
```

## Contribution Workflow (High Level)

1. Implement or update connector YAML under `src/main/connector/...`
2. Add or update replay test data under `src/it/resources/<ConnectorId>/...`
3. Register/update IT execution in `src/it/java/...`
4. Validate locally (`mvn clean site`, then `mvn verify` when relevant)
5. Open a PR with clear behavior changes and evidence

> **Tip**
>
> For new work, prefer modern patterns documented in the guide: explicit source names, reusable `beforeAll` data, deterministic detection, and clear normalization pipelines.

## External Links

- Repository: [metricshub/community-connectors](https://github.com/metricshub/community-connectors)
- MetricsHub Website: [metricshub.com](https://metricshub.com)