You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Aggregates samples into configurable time buckets (e.g. 1 second, 1 minute, etc.) published by metrics client libraries (e.g. [Java](https://github.com/ArpNetworking/metrics-client-java), [NodeJS](https://github.com/ArpNetworking/metrics-client-nodejs), [Ruby](https://github.com/ArpNetworking/metrics-client-ruby), etc.) to compute a variety of statistics. The statistics are reaggregatable and are published together with supporting data to configurable destination(s).
18
+
Aggregates samples into configurable time buckets (e.g. 1 second, 1 minute, etc.) published by metrics client libraries
[Ruby](https://github.com/ArpNetworking/metrics-client-ruby), etc.) to compute a variety of statistics. The statistics
22
+
are reaggregatable and are published together with supporting data to configurable destination(s).
19
23
20
24
21
25
Usage
@@ -24,23 +28,30 @@ Usage
24
28
### Installation
25
29
26
30
#### Manual
27
-
The artifacts from the build are in *metrics-aggregator-daemon/target/appassembler* and should be copied to an appropriate directory on your application host(s).
31
+
The artifacts from the build are in *metrics-aggregator-daemon/target/appassembler* and should be copied to an
32
+
appropriate directory on your application host(s).
28
33
29
34
#### Docker
30
-
If you use Docker, we publish a base docker image that makes it easy for you to layer configuration on top of. Create a Docker image based on the image arpnetworking/mad. Configuration files are typically located at /opt/mad/config/ with pipeline files located at /opt/mad/config/pipelines. In addition, you can specify CONFIG_FILE (defaults to /opt/mad/config/config.json), PARAMS (defaults to $CONFIG_FILE), LOGGING_CONFIG (defaults to "-Dlogback.configurationFile=/opt/mad/config/logback.xml"), and JAVA_OPTS (defaults to $LOGGING_CONFIG) environment variables to control startup.
35
+
If you use Docker, we publish a base docker image that makes it easy for you to layer configuration on top of. Create
36
+
a Docker image based on the image arpnetworking/mad. Configuration files are typically located at /opt/mad/config/
37
+
with pipeline files located at /opt/mad/config/pipelines. In addition, you can specify CONFIG_FILE (defaults to
38
+
/opt/mad/config/config.json), PARAMS (defaults to $CONFIG_FILE), LOGGING_CONFIG (defaults to
39
+
"-Dlogback.configurationFile=/opt/mad/config/logback.xml"), and JAVA_OPTS (defaults to "") environment variables to
40
+
control startup.
31
41
32
42
### Execution
33
43
34
-
In the installation's *bin* directory there are scripts to start Metrics Aggregator Daemon: *mad* (Linux) and *mad.bat* (Windows). One of these should be executed on system start with appropriate parameters; for example:
44
+
In the installation's *bin* directory there are scripts to start Metrics Aggregator Daemon: *mad* (Linux) and
45
+
*mad.bat* (Windows). One of these should be executed on system start with appropriate parameters; for example:
To customize logging you may provide a [LogBack](http://logback.qos.ch/) configuration file. The project ships with`logback.xml` which
43
-
writes logs to rotated files and with `logback-console.xml` which writes logs to STDOUT.
53
+
To customize logging you may provide a [LogBack](http://logback.qos.ch/) configuration file. The project ships with
54
+
`logback.xml` which writes logs to rotated files and with `logback-console.xml` which writes logs to STDOUT.
44
55
45
56
Outside of Docker, set the `JAVA_OPTS` environment variable to configure logging:
46
57
@@ -54,7 +65,8 @@ Under Docker, set the `LOGBACK_CONFIG` environment variable to configure logging
54
65
55
66
#### Daemon
56
67
57
-
The Metrics Aggregator Daemon configuration is specified in a JSON file. The location of the configuration file is passed to *mad* as a command line argument:
68
+
The Metrics Aggregator Daemon configuration is specified in a JSON file. The location of the configuration file is
One instance of Metrics Aggregator daemon supports multiple independent services on the same host. The most basic single application host still typically configures two services: i) the end-user application running on the host, and ii) the system metrics captured by CollectD. Each of these services is configured as a pipeline in Metrics Aggregator Daemon. The pipeline defines the name of the service, one or more sources of metrics and one more destinations or sinks for the aggregated statistics.
117
+
One instance of Metrics Aggregator daemon supports multiple independent services on the same host. The most basic
118
+
single application host still typically configures two services: i) the end-user application running on the host,
119
+
and ii) the system metrics captured by CollectD. Each of these services is configured as a pipeline in Metrics
120
+
Aggregator Daemon. The pipeline defines the name of the service, one or more sources of metrics and one more
121
+
destinations or sinks for the aggregated statistics.
106
122
107
123
For example:
108
124
@@ -140,11 +156,13 @@ For example:
140
156
}
141
157
```
142
158
143
-
Each of the pipeline configuration files should be placed in the *pipelinesDirectory* defined as part of the daemon configuration above.
159
+
Each of the pipeline configuration files should be placed in the *pipelinesDirectory* defined as part of the daemon
160
+
configuration above.
144
161
145
162
#### Hocon
146
163
147
-
The daemon and pipeline configuration files may be written in [Hocon](https://github.com/typesafehub/config) when specified with a _.conf extension.
164
+
The daemon and pipeline configuration files may be written in [Hocon](https://github.com/typesafehub/config) when
165
+
specified with a _.conf extension.
148
166
149
167
### Sources
150
168
@@ -297,7 +315,8 @@ To use the local version in your project you must first install it locally:
0 commit comments