https://github.com/cch0/mad-for-dev

Docker based MAD for development environment
https://github.com/cch0/mad-for-dev

Last synced: about 1 year ago
JSON representation

Docker based MAD for development environment

• Host: GitHub
• URL: https://github.com/cch0/mad-for-dev
• Owner: cch0
• Created: 2019-07-13T02:22:27.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2019-07-18T03:32:31.000Z (almost 7 years ago)
• Last Synced: 2025-02-12T15:36:52.234Z (over 1 year ago)
• Language: TypeScript
• Size: 429 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# MAD for Dev

# Purpose

To provide a [`Metrics Aggregator Daemon`](https://github.com/ArpNetworking/metrics-aggregator-daemon) based metrics collection and visualization solution suitable for development environment.

Implementation of the solution is based on docker and to be used by `docker-compose`.

![architecture](./img/mad_for_dev.png)

## Caution

Not suitable for production use. No metrics data is retained. No high availability. Dashboard and data source configuration are not persisted.

# Run It

From the top directory,

```

docker-compose -f docker-compose.yml up -d

```

# Metrics Aggregator Daemon (MAD)

MAD is available at port `7090` and `8125` (udp)

# Metrics Portal (mportal)

mportal is available at port `8080` and `9000` and UI is available at `localhost:8081`

By default, metrics from both `MAD` and `mportal` are available and shown in the left panel.

![mportal 01](./img/mportal01.png)

When application/service is pushing metrics to `MAD` with `service` tag of value `ams`, then metrics will show up under `ams` as well.

![mportal 02](./img/mportal02.png)

# Metrics Cluster Aggregator (CAGG)

CAGG is available at port `7065` and `7066`.

# Cassandra

Cassandra is available at port `7000` and `9042`.

# KairosDB

Kairosdb is available at port `8080` and UI is available at `localhost:8082`

![kairosdb](./img/kairosdb01.png)

# Grafana 

Grafana is available at port `3000` and UI is available at `localhost:3000`

## Grafana Data Source Configuration

Grafana has had Kairosdb plugin installed. All is left is to configure data source

![kairosdb datasource](./img/grafana_datasource_kairosdb.png)

# Integration With Spring Boot Application

In the `application.yaml` file, enable statsd metrics.

```

management:

  metrics:

    export:

      statsd:

        enabled: true

        flavor: datadog

        host: "localhost"

        port: 8125

      simple:

        enabled: false

```

In order for MAD to correctly ingest metrics, the following 3 tags must be present in the metric.

* cluster: value of `monitoringCluster` variable configured in [config.conf](./mad/config/config.conf), default is "mad"

* service: name of your service

* host: localhost or something similar