// Copyright The 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. package metric import ( "bytes" "sync" "go.opentelemetry.io/otel/api/core" export "go.opentelemetry.io/otel/sdk/export/metric" ) // escapeChar is used to ensure uniqueness of the label encoding where // keys or values contain either '=' or ','. Since there is no parser // needed for this encoding and its only requirement is to be unique, // this choice is arbitrary. Users will see these in some exporters // (e.g., stdout), so the backslash ('\') is used a conventional choice. const escapeChar = '\\' type defaultLabelEncoder struct { // pool is a pool of labelset builders. The buffers in this // pool grow to a size that most label encodings will not // allocate new memory. This pool reduces the number of // allocations per new LabelSet to 3, typically, as seen in // the benchmarks. (It should be 2--one for the LabelSet // object and one for the buffer.String() here--see the extra // allocation in the call to sort.Stable). pool sync.Pool // *bytes.Buffer } var _ export.LabelEncoder = &defaultLabelEncoder{} func NewDefaultLabelEncoder() export.LabelEncoder { return &defaultLabelEncoder{ pool: sync.Pool{ New: func() interface{} { return &bytes.Buffer{} }, }, } } func (d *defaultLabelEncoder) Encode(iter export.LabelIterator) string { buf := d.pool.Get().(*bytes.Buffer) defer d.pool.Put(buf) buf.Reset() for iter.Next() { i, kv := iter.IndexedLabel() if i > 0 { _, _ = buf.WriteRune(',') } copyAndEscape(buf, string(kv.Key)) _, _ = buf.WriteRune('=') if kv.Value.Type() == core.STRING { copyAndEscape(buf, kv.Value.AsString()) } else { _, _ = buf.WriteString(kv.Value.Emit()) } } return buf.String() } func copyAndEscape(buf *bytes.Buffer, val string) { for _, ch := range val { switch ch { case '=', ',', escapeChar: buf.WriteRune(escapeChar) } buf.WriteRune(ch) } }