opentelemetry_api_experimental

%%%------------------------------------------------------------------------
%% Copyright 2022, OpenTelemetry Authors
%% Licensed 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.
%%
%% @doc Histogram is a synchronous Instrument which can be used to report
%% arbitrary values that are likely to be statistically meaningful. It is
%% intended for statistics such as histograms, summaries, and percentile.
%% @end
%%%-------------------------------------------------------------------------
-module(otel_histogram).

-export([record/3]).

-include("otel_metrics.hrl").
-include_lib("kernel/include/logger.hrl").

-spec record(otel_instrument:t(), number(), opentelemetry:attributes_map()) -> ok.
record(Instrument=#instrument{module=Module,
                              value_type=?VALUE_TYPE_INTEGER}, Number, Attributes)
  when is_integer(Number) ->
    Module:record(Instrument, Number, Attributes);
record(Instrument=#instrument{module=Module,
                              value_type=?VALUE_TYPE_FLOAT}, Number, Attributes)
  when is_float(Number) ->
    Module:record(Instrument, Number, Attributes);
record(#instrument{name=Name,
                   value_type=?VALUE_TYPE_INTEGER}, Number, _) ->
    ?LOG_DEBUG("Histogram instrument ~p does not support adding value ~p. "
               "The value must be an integer.", [Name, Number]),
    ok;
record(#instrument{name=Name,
                   value_type=?VALUE_TYPE_FLOAT}, Number, _) ->
    ?LOG_DEBUG("Histogram instrument ~p does not support adding value ~p. "
               "The value must be a float.", [Name, Number]),
    ok.