dclim commented on a change in pull request #6658: add ganglia emitter extension URL: https://github.com/apache/incubator-druid/pull/6658#discussion_r243411147
########## File path: docs/content/development/extensions-contrib/ganglia-emitter.md ########## @@ -0,0 +1,66 @@ +<!-- + ~ Licensed to the Apache Software Foundation (ASF) under one + ~ or more contributor license agreements. See the NOTICE file + ~ distributed with this work for additional information + ~ regarding copyright ownership. The ASF licenses this file + ~ to you under the Apache License, Version 2.0 (the + ~ "License"); you may not use this file except in compliance + ~ with the License. You may obtain a copy of the License at + ~ + ~ http://www.apache.org/licenses/LICENSE-2.0 + ~ + ~ Unless required by applicable law or agreed to in writing, + ~ software distributed under the License is distributed on an + ~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + ~ KIND, either express or implied. See the License for the + ~ specific language governing permissions and limitations + ~ under the License. + --> + +--- +layout: doc_page +--- + +# Ganglia Emitter + +To use this extension, make sure to [include](../../operations/including-extensions.html) `ganglia-emitter` extension. + +## Introduction + +This extension emits druid metrics to a Ganglia server. +(http://ganglia.info/) + +## Configuration + +All the configuration parameters for the Ganglia emitter are under `druid.emitter.ganglia`. + +|property|description|required?|default| +|--------|-----------|---------|-------| +|`druid.emitter.ganglia.hostname`|The hostname of the Ganglia server.|yes|none| +|`druid.emitter.ganglia.port`|The port of the Ganglia server.|yes|none| +|`druid.emitter.ganglia.separator`|Metric name separator|no|.| +|`druid.emitter.ganglia.includeHost`|Flag to include the hostname as part of the metric name.|no|false| +|`druid.emitter.ganglia.dimensionMapPath`|JSON file defining the Ganglia type, and desired dimensions for every Druid metric|no|Default mapping provided. See below.| +|`druid.emitter.ganglia.blankHolder`|The blank character replacement as Ganglia does not support path with blank character|no|"-"| +|`druid.emitter.ganglia.flushPeriod` | Queue flushing period in milliseconds. |no|1 minute| +|`druid.emitter.ganglia.loadPeriod` | Load metrics config period in milliseconds. |no|1 minute| +|`druid.emitter.ganglia.maxQueueSize`| Maximum size of the queue used to buffer events. |no|`MAX_INT`| +|`druid.emitter.ganglia.emitWaitTime` | wait time in milliseconds to try to send the event otherwise emitter will throwing event. |no|0| Review comment: This doesn't seem to be the wait time for sending the event, but rather the wait time for the blocking queue to accept the event. Maybe reword this as something like 'Wait time in milliseconds for send buffer to accept before dropping an event' ---------------------------------------------------------------- This is an automated message from the Apache Git Service. To respond to the message, please log on GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: [email protected] With regards, Apache Git Services --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
