Skip to content

Commit

Permalink
#96 add README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
xp-1000 committed Nov 6, 2020
1 parent a748c1e commit 443716f
Show file tree
Hide file tree
Showing 3 changed files with 117 additions and 6 deletions.
13 changes: 13 additions & 0 deletions CODE_OF_CONDUCT.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,18 @@
# Contributor Covenant Code of Conduct

<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
:link: **Contents**

- [Our Pledge](#our-pledge)
- [Our Standards](#our-standards)
- [Our Responsibilities](#our-responsibilities)
- [Scope](#scope)
- [Enforcement](#enforcement)
- [Attribution](#attribution)

<!-- END doctoc generated TOC please keep comment here to allow auto update -->

## Our Pledge

In the interest of fostering an open and welcoming environment, we as
Expand Down
29 changes: 23 additions & 6 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,27 @@
# Contributing

All contributions and pull requests are welcome!

## Workflow

### General
<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
:link: **Contents**

- [General](#general)
- [Detectors](#detectors)
- [Scope](#scope)
- [Example](#example)
- [Limits](#limits)
- [Criteria](#criteria)
- [Templating tips and rules](#templating-tips-and-rules)
- [Modules structure](#modules-structure)
- [Variables](#variables)
- [Default values](#default-values)
- [Filtering](#filtering)
- [Severity](#severity)
- [No data](#no-data)
- [Documentation](#documentation)

<!-- END doctoc generated TOC please keep comment here to allow auto update -->

## General

* to propose change, simply submit a pull request (no issue required).
* if you are not sure, create it as draft this will allow code owners
Expand All @@ -14,7 +31,7 @@ discuss.
* there are several issue templates available for common needs, please
select it appropriately.

# Detectors
## Detectors

* to update existing detectors do the change directly in code.
* to add new detectors in existing modules use [the jinja
Expand Down
81 changes: 81 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,81 @@
# SignalFx Detectors
[![Maintainer](https://img.shields.io/badge/maintained%20by-claranet-red?style=flat-square)](https://www.claranet.fr/)
[![License](https://img.shields.io/github/license/claranet/terraform-signalfx-detectors?style=flat-square)](LICENSE)
[![Release](https://img.shields.io/github/v/release/claranet/terraform-signalfx-detectors?style=flat-square)](https://github.com/claranet/terraform-signalfx-detectors/releases)
[![Status](https://img.shields.io/github/workflow/status/claranet/terraform-signalfx-detectors/Detectors?style=flat-square&label=tests)](https://github.com/claranet/terraform-signalfx-detectors/actions?query=workflow%3ADetectors)
[![Terraform version](https://img.shields.io/badge/terraform-%3E%3D0.12.26-623CE4.svg?style=flat-square&logo=terraform)](https://github.com/hashicorp/terraform)
[![Terraform registry](https://img.shields.io/badge/terraform-registry-623CE4.svg?style=flat-square&logo=terraform)](https://registry.terraform.io/modules/claranet/detectors/signalfx)

> Most alerting rules are common to every users. Here is a place to "rule" them all! :gift: :rotating_light: :metal:
<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
:link: **Contents**

- [:loudspeaker: Goal](#loudspeaker-goal)
- [:bell: Modules](#bell-modules)
- [:running: Usage](#running-usage)
- [:handshake: Contributing](#handshake-contributing)
- [:construction: Roadmap](#construction-roadmap)
- [:warning: Changelog](#warning-changelog)
- [:memo: License](#memo-license)

<!-- END doctoc generated TOC please keep comment here to allow auto update -->

## :loudspeaker: Goal

This aims to speed up alerting deployment and apply infrastructure as code process
to monitoring. It could also be a place to collect, share and improve alerting rules
on popular tools and environments through SignalFx and Terraform.

__Note__: These templates implementation is opinionated and enforce best practices
which ensure homogeneity but will also restrict the usage and capabilities even if
it tries to provide as much flexibility as possible.

## :bell: Modules

This repository consists in a collection of generic pre-built detectors for SignalFx
broken down into multiple terraform modules in [modules](./modules/README.md) directory.

Each module is fully independent and it is dedicated to monitor one service
thanks to the metrics and information it provides. It contains:

- Terraform source code to be use as module
- Readme file containing instructions and notes specific to work with the module.
- Source, dependencies and sample configuration for metrics collection.

## :running: Usage

A module is a collection of [detectors
resource](https://registry.terraform.io/providers/splunk-terraform/signalfx/latest/docs/resources/detector)
with global and per-detector variables available to adapt the default alerting
behavior to suit your requirements chaning underlying detectors configuration
at deployment thanks to Terraform.

[Instructions in Wiki](https://github.com/claranet/terraform-signalfx-detectors/wiki).

## :handshake: Contributing

Contributions from community are most welcome!

There are many ways to contribute: writing code, add or improve detectors,
documentation, reporting issues, discussing better error tracking...

[Instructions in CONTRUBITING.md](CONTRIBUTING.md).

## :construction: Roadmap

You can go to [github
milestones](https://github.com/claranet/terraform-signalfx-detectors/milestones)
to know what is planned in future versions browsing [available
issues](https://github.com/claranet/terraform-signalfx-detectors/issues).

## :warning: Changelog

Read carefully release notes of each [github
release](https://github.com/claranet/terraform-signalfx-detectors/releases)
before upgrading to a new version.

## :memo: License

[Mozilla Public License](https://www.mozilla.org/en-US/MPL/)

0 comments on commit 443716f

Please sign in to comment.