{"id":"d2c5f67cf47d902f","repo":"go-redis/redis","slug":"failed-to-create-maintenance-notifications-metric","errorCode":null,"errorMessage":"failed to create maintenance notifications metric: %w","messagePattern":"failed to create maintenance notifications metric: %w","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"extra/redisotel-native/redisotel.go","lineNumber":264,"sourceCode":"\tvar maintenanceNotifications metric.Int64Counter\n\n\tif cfg.isMetricGroupEnabled(MetricGroupResiliency) {\n\t\tclientErrors, err = meter.Int64Counter(\n\t\t\tMetricClientErrors,\n\t\t\tmetric.WithDescription(\"Number of errors handled by the Redis client\"),\n\t\t\tmetric.WithUnit(\"{error}\"),\n\t\t)\n\t\tif err != nil {\n\t\t\treturn nil, fmt.Errorf(\"failed to create client errors metric: %w\", err)\n\t\t}\n\n\t\tmaintenanceNotifications, err = meter.Int64Counter(\n\t\t\tMetricMaintenanceNotifications,\n\t\t\tmetric.WithDescription(\"Number of maintenance notifications received\"),\n\t\t\tmetric.WithUnit(\"{notification}\"),\n\t\t)\n\t\tif err != nil {\n\t\t\treturn nil, fmt.Errorf(\"failed to create maintenance notifications metric: %w\", err)\n\t\t}\n\t}\n\n\tvar connectionWaitTime metric.Float64Histogram\n\tvar connectionClosed metric.Int64Counter\n\tvar connectionPendingReqs metric.Int64UpDownCounter // OTel semconv: UpDownCounter\n\n\tif cfg.isMetricGroupEnabled(MetricGroupConnectionAdvanced) {\n\t\tvar connectionWaitTimeOpts []metric.Float64HistogramOption\n\t\tif cfg.histAggregation == HistogramAggregationExplicitBucket {\n\t\t\tconnectionWaitTimeOpts = append(connectionWaitTimeOpts,\n\t\t\t\tmetric.WithExplicitBucketBoundaries(cfg.bucketsConnectionWaitTime...),\n\t\t\t)\n\t\t}\n\t\tvar connectionWaitTimeConv dbconv.ClientConnectionWaitTime\n\t\tconnectionWaitTimeConv, err = dbconv.NewClientConnectionWaitTime(meter, connectionWaitTimeOpts...)\n\t\tif err != nil {\n\t\t\treturn nil, fmt.Errorf(\"failed to create connection wait time histogram: %w\", err)","sourceCodeStart":246,"sourceCodeEnd":282,"githubUrl":"https://github.com/go-redis/redis/blob/36d97525cd8076aed67cddf54778e9ea84550929/extra/redisotel-native/redisotel.go#L246-L282","documentation":"Returned by createRecorder (redisotel.go:264) when meter.Int64Counter fails to create the 'redis.client.maintenance.notifications' instrument. Only checked when MetricGroupResiliency is enabled.","triggerScenarios":"Calling Init with MetricGroupFlagResiliency enabled, and the OTel SDK rejects the Counter creation.","commonSituations":"Another library registered 'redis.client.maintenance.notifications' with conflicting metadata; conflicting redisotel versions; broken MeterProvider.","solutions":["Reconcile other registrations of 'redis.client.maintenance.notifications' to use Int64Counter with matching unit '{notification}' and description","Resolve redisotel version conflicts in go.mod","Verify MeterProvider validity"],"exampleFix":"// before - conflicting description from another lib\nmeter.Int64Counter(\"redis.client.maintenance.notifications\",\n    metric.WithDescription(\"maintenance events\"))\n\n// after - match redisotel's description\nmeter.Int64Counter(\"redis.client.maintenance.notifications\",\n    metric.WithDescription(\"Number of maintenance notifications received\"))","handlingStrategy":"try-catch","validationCode":null,"typeGuard":null,"tryCatchPattern":"if err := obs.Init(cfg); err != nil {\n    if strings.Contains(err.Error(), \"maintenance notifications metric\") {\n        log.Error(\"conflict on 'redis.client.maintenance.notifications'; reconcile metadata\")\n    }\n}","preventionTips":["Ensure no other library registers 'redis.client.maintenance.notifications' with conflicting metadata","Resolve redisotel version conflicts in go.mod","Verify MeterProvider validity"],"tags":["otel","redisotel-native","metrics","resiliency","counter","maintenance"],"analyzedSha":"36d97525cd8076aed67cddf54778e9ea84550929","analyzedAt":"2026-08-06T01:08:27.376Z","schemaVersion":2}