com.signalfx.codahale.reporter.MetricMetadata Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of signalfx-yammer Show documentation

Codahale yammer metrics plugin for signalfx / yammer metrics lib v2.0

There is a newer version: 1.0.43

package com.signalfx.codahale.reporter;

import java.util.Map;
import com.yammer.metrics.core.Metric;
import com.yammer.metrics.core.MetricsRegistry;
import com.google.common.base.Optional;
import com.signalfx.metrics.protobuf.SignalFxProtocolBuffers;

/**
 * Allows users to modify a metric with different source or metric parts than the default we pick
 * from codahale.  Note: This class must be thread safe.
 */
public interface MetricMetadata {
    public static final String SOURCE = "source";
    public static final String METRIC = "metric";
    public Map getTags(Metric metric);
    public Optional getMetricType(Metric metric);

    /**
     * Create an object to tag a metric with data.  Registering two different metrics with the same
     * metadata will result in an exception.
     * @param metric    The metric will tag.
     * @param        The type of metric.  It is implied by the metric type.
     * @return An object to tag the given metric.
     */
    public  Tagger forMetric(M metric);

    @Deprecated
    public  Tagger tagMetric(M metric);

    public interface TaggerBase> {
        /**
         *  Tag the metric with a sf_source
         * @param sourceName    Source name for the sf_source
         * @return this
         * @deprecated The use of the build in source parameter is deprecated and discouraged.  Use
         *             {@link #withDimension(String, String)} instead.
         */
        T withSourceName(String sourceName);

        /**
         * Changes the metric name of this metric from the default (which is the codahale metric
         * name), to another string
         * @param metricName    The new name in SignalFx of this metric
         * @return this
         */
        T withMetricName(String metricName);

        /**
         * Adds a dimension to this metric
         * @param key      The dimension key to add
         * @param value    The dimensino value to add
         * @return this
         */
        T withDimension(String key, String value);

        /**
         * Changes the default metric type of this metric to the SignalFx metric type passed in
         * @param metricType    The new metric type of this metric
         * @return this
         */
        T withMetricType(SignalFxProtocolBuffers.MetricType metricType);
    }

    public interface Tagger extends TaggerBase> {

        /**
         * Returns the tagged metric
         * @return the tagged metric
         */
        M metric();
    }

}