consul/agent/hcp/deps.go

100 lines
2.9 KiB
Go

// Copyright (c) HashiCorp, Inc.
// SPDX-License-Identifier: BUSL-1.1
package hcp
import (
"context"
"fmt"
"github.com/armon/go-metrics"
"github.com/hashicorp/go-hclog"
"go.opentelemetry.io/otel"
"github.com/hashicorp/consul/agent/hcp/client"
"github.com/hashicorp/consul/agent/hcp/config"
"github.com/hashicorp/consul/agent/hcp/scada"
"github.com/hashicorp/consul/agent/hcp/telemetry"
)
// Deps contains the interfaces that the rest of Consul core depends on for HCP integration.
type Deps struct {
Config config.CloudConfig
Provider scada.Provider
Sink metrics.ShutdownSink
TelemetryProvider *hcpProviderImpl
DataDir string
}
func NewDeps(cfg config.CloudConfig, logger hclog.Logger, dataDir string) (Deps, error) {
ctx := context.Background()
ctx = hclog.WithContext(ctx, logger)
provider, err := scada.New(logger.Named("scada"))
if err != nil {
return Deps{}, fmt.Errorf("failed to init scada: %w", err)
}
metricsProvider := NewHCPProvider(ctx)
if err != nil {
logger.Error("failed to init HCP metrics provider", "error", err)
return Deps{}, fmt.Errorf("failed to init HCP metrics provider: %w", err)
}
metricsClient := client.NewMetricsClient(ctx, metricsProvider)
sink, err := newSink(ctx, metricsClient, metricsProvider)
if err != nil {
// Do not prevent server start if sink init fails, only log error.
logger.Error("failed to init sink", "error", err)
}
return Deps{
Config: cfg,
Provider: provider,
Sink: sink,
TelemetryProvider: metricsProvider,
DataDir: dataDir,
}, nil
}
// newSink initializes an OTELSink which forwards Consul metrics to HCP.
// This step should not block server initialization, errors are returned, only to be logged.
func newSink(
ctx context.Context,
metricsClient telemetry.MetricsClient,
cfgProvider *hcpProviderImpl,
) (metrics.ShutdownSink, error) {
logger := hclog.FromContext(ctx)
// Set the global OTEL error handler. Without this, on any failure to publish metrics in
// otelExporter.Export, the default OTEL handler logs to stderr without the formatting or group
// that hclog provides. Here we override that global error handler once so logs are
// in the standard format and include "hcp" in the group name like:
// 2024-02-06T22:35:19.072Z [ERROR] agent.hcp: failed to export metrics: failed to export metrics: code 404: 404 page not found
otel.SetErrorHandler(&otelErrorHandler{logger: logger})
reader := telemetry.NewOTELReader(metricsClient, cfgProvider)
sinkOpts := &telemetry.OTELSinkOpts{
Reader: reader,
ConfigProvider: cfgProvider,
}
sink, err := telemetry.NewOTELSink(ctx, sinkOpts)
if err != nil {
return nil, fmt.Errorf("failed to create OTELSink: %w", err)
}
logger.Debug("initialized HCP metrics sink")
return sink, nil
}
type otelErrorHandler struct {
logger hclog.Logger
}
func (o *otelErrorHandler) Handle(err error) {
o.logger.Error(err.Error())
}