We're glad that you would like to become a Percona community member and participate in keeping open source open. This is the new MongoDB exporter implementation that handles ALL metrics exposed by MongoDB monitoring commands. This implementation loops over all the fields exposed in diagnostic commands and tries to get data from them.
Before submitting code or documentation contributions, you should first complete the following prerequisites.
Before you can contribute, we kindly ask you to sign our Contributor License Agreement (CLA). You can do this using your GitHub account and one click.
Please make sure to read and agree to our Code of Conduct.
If you find a bug in Percona MongoDB Exporter and it is not related to PMM, please open issue in GitHub new issue, if you use PMM, please submit a report to that project's JIRA issue tracker.
Your first step should be to search GH issues and JIRA PMM issues for the existing set of open tickets for a similar report. If you find that someone else has already reported your problem, then you can upvote that report to increase its visibility.
If there is no existing PMM report for the issue that relates to PMM, submit a report following these steps:
- Sign in to Percona JIRA. You will need to create an account if you do not have one.
- Go to the Create Issue screen and select the relevant project.
- Fill in the fields of Summary, Description, Steps To Reproduce, and Affects Version to the best you can. If the bug corresponds to a crash, attach the stack trace from the logs.
An excellent resource is Elika Etemad's article on filing good bug reports..
As a general rule of thumb, please try to create bug reports that are:
- Reproducible. Include steps to reproduce the problem.
- Specific. Include as much detail as possible: which version, what environment, etc.
- Unique. Do not duplicate existing tickets.
- Scoped to a Single Bug. One bug per report.
MongoDB exporter uses Semantic Versioning [major].[minor].[patch]:
- major version when you make incompatible changes
- minor version when you add functionality in a backwards compatible manner
- patch version when you make backwards compatible bug fixes
main is a main branch where all the changes are merged first.
release-x.y are the release branches and are forked from main to prepare and test the release. Release branch stays open to get critical patches and to release another patch release. Release branch closes (no merges happens) just after new minor release is created.
Each release is tagged with vx.y.z tag.
Please submit your changes against main branch, if the fix is needed for the patch or minor release - please ask maintainers to cherry pick it into the release branch.
In the main directory there is a Makefile to help you with development and testing tasks.
Use make without parameters to get help.
These are these available options:
| Command | Description |
|---|---|
| init | Install linters |
| build | Build the binaries |
| format | Format source code |
| check | Run checks/linters |
| check-license | Check license in headers. |
| help | Display this help message. |
| test | Run all tests (need to start the sandbox first) |
| test-cluster | Starts MongoDB test cluster. Use env var TEST_MONGODB_IMAGE to set flavor and version. Example: |
TEST_MONGODB_IMAGE=mongo:3.6 make test-cluster |
|
| test-cluster-clean | Stops MongoDB test cluster |
First you need to have Go and Docker installed on your system and then, in order to install tools to format, test and build the exporter, you need to run this command:
make init
It will install goimports, goreleaser, golangci-lint and reviewdog.
The testing sandbox starts n MongoDB instances as follows:
- 3 Instances for shard 1 at ports 17001, 17002, 17003 (with no authentication)
- 3 instances for shard 2 at ports 17004, 17005, 17006 (with authentication enabled)
- 3 config servers at ports 17007, 17008, 17009
- 1 mongos server at port 17000
- 1 stand alone instance at port 27017
To connect to the mongos on shard 1, you can use:
mongo mongodb://127.0.0.1:17001/admin
To connect to the mongos on shard 2 (with authentication enabled), you can use:
mongo mongodb://admin:admin@127.0.0.1:17001/admin
The sandbox can be started using the provided Makefile using: make test-cluster and it can be stopped using make test-cluster-clean.
To run the unit tests, just run make test.
Before submitting code, please run make format to format the code according to the standards.
Submit your code against the main branch.
After submitting your PR please add pmm-review-exporters team as a reviewer - that would auto assign reviewers to review your PR.
Once your pull request is merged, you are an official Percona Community Contributor. Welcome to the community!
We're looking forward to your contributions and hope to hear from you soon on our Forums.