259 lines
		
	
	
		
			9.3 KiB
		
	
	
	
		
			Python
		
	
	
	
			
		
		
	
	
			259 lines
		
	
	
		
			9.3 KiB
		
	
	
	
		
			Python
		
	
	
	
# 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.
 | 
						|
 | 
						|
import os
 | 
						|
from unittest import TestCase
 | 
						|
from unittest.mock import Mock, patch
 | 
						|
 | 
						|
from opentelemetry.instrumentation._semconv import (
 | 
						|
    OTEL_SEMCONV_STABILITY_OPT_IN,
 | 
						|
    _OpenTelemetrySemanticConventionStability,
 | 
						|
    _OpenTelemetryStabilitySignalType,
 | 
						|
    _set_status,
 | 
						|
    _StabilityMode,
 | 
						|
)
 | 
						|
from opentelemetry.trace.status import StatusCode
 | 
						|
 | 
						|
 | 
						|
def stability_mode(mode):
 | 
						|
    def decorator(test_case):
 | 
						|
        @patch.dict(os.environ, {OTEL_SEMCONV_STABILITY_OPT_IN: mode})
 | 
						|
        def wrapper(*args, **kwargs):
 | 
						|
            _OpenTelemetrySemanticConventionStability._initialized = False
 | 
						|
            _OpenTelemetrySemanticConventionStability._initialize()
 | 
						|
            return test_case(*args, **kwargs)
 | 
						|
 | 
						|
        return wrapper
 | 
						|
 | 
						|
    return decorator
 | 
						|
 | 
						|
 | 
						|
class TestOpenTelemetrySemConvStability(TestCase):
 | 
						|
    @stability_mode("")
 | 
						|
    def test_default_mode(self):
 | 
						|
        self.assertEqual(
 | 
						|
            _OpenTelemetrySemanticConventionStability._get_opentelemetry_stability_opt_in_mode(
 | 
						|
                _OpenTelemetryStabilitySignalType.HTTP
 | 
						|
            ),
 | 
						|
            _StabilityMode.DEFAULT,
 | 
						|
        )
 | 
						|
        self.assertEqual(
 | 
						|
            _OpenTelemetrySemanticConventionStability._get_opentelemetry_stability_opt_in_mode(
 | 
						|
                _OpenTelemetryStabilitySignalType.DATABASE
 | 
						|
            ),
 | 
						|
            _StabilityMode.DEFAULT,
 | 
						|
        )
 | 
						|
 | 
						|
    @stability_mode("http")
 | 
						|
    def test_http_stable_mode(self):
 | 
						|
        self.assertEqual(
 | 
						|
            _OpenTelemetrySemanticConventionStability._get_opentelemetry_stability_opt_in_mode(
 | 
						|
                _OpenTelemetryStabilitySignalType.HTTP
 | 
						|
            ),
 | 
						|
            _StabilityMode.HTTP,
 | 
						|
        )
 | 
						|
 | 
						|
    @stability_mode("http/dup")
 | 
						|
    def test_http_dup_mode(self):
 | 
						|
        self.assertEqual(
 | 
						|
            _OpenTelemetrySemanticConventionStability._get_opentelemetry_stability_opt_in_mode(
 | 
						|
                _OpenTelemetryStabilitySignalType.HTTP
 | 
						|
            ),
 | 
						|
            _StabilityMode.HTTP_DUP,
 | 
						|
        )
 | 
						|
 | 
						|
    @stability_mode("database")
 | 
						|
    def test_database_stable_mode(self):
 | 
						|
        self.assertEqual(
 | 
						|
            _OpenTelemetrySemanticConventionStability._get_opentelemetry_stability_opt_in_mode(
 | 
						|
                _OpenTelemetryStabilitySignalType.DATABASE
 | 
						|
            ),
 | 
						|
            _StabilityMode.DATABASE,
 | 
						|
        )
 | 
						|
 | 
						|
    @stability_mode("database/dup")
 | 
						|
    def test_database_dup_mode(self):
 | 
						|
        self.assertEqual(
 | 
						|
            _OpenTelemetrySemanticConventionStability._get_opentelemetry_stability_opt_in_mode(
 | 
						|
                _OpenTelemetryStabilitySignalType.DATABASE
 | 
						|
            ),
 | 
						|
            _StabilityMode.DATABASE_DUP,
 | 
						|
        )
 | 
						|
 | 
						|
    @stability_mode("database,http")
 | 
						|
    def test_multiple_stability_database_http_modes(self):
 | 
						|
        self.assertEqual(
 | 
						|
            _OpenTelemetrySemanticConventionStability._get_opentelemetry_stability_opt_in_mode(
 | 
						|
                _OpenTelemetryStabilitySignalType.DATABASE
 | 
						|
            ),
 | 
						|
            _StabilityMode.DATABASE,
 | 
						|
        )
 | 
						|
        self.assertEqual(
 | 
						|
            _OpenTelemetrySemanticConventionStability._get_opentelemetry_stability_opt_in_mode(
 | 
						|
                _OpenTelemetryStabilitySignalType.HTTP
 | 
						|
            ),
 | 
						|
            _StabilityMode.HTTP,
 | 
						|
        )
 | 
						|
 | 
						|
    @stability_mode("database,http/dup")
 | 
						|
    def test_multiple_stability_database_http_dup_modes(self):
 | 
						|
        self.assertEqual(
 | 
						|
            _OpenTelemetrySemanticConventionStability._get_opentelemetry_stability_opt_in_mode(
 | 
						|
                _OpenTelemetryStabilitySignalType.DATABASE
 | 
						|
            ),
 | 
						|
            _StabilityMode.DATABASE,
 | 
						|
        )
 | 
						|
        self.assertEqual(
 | 
						|
            _OpenTelemetrySemanticConventionStability._get_opentelemetry_stability_opt_in_mode(
 | 
						|
                _OpenTelemetryStabilitySignalType.HTTP
 | 
						|
            ),
 | 
						|
            _StabilityMode.HTTP_DUP,
 | 
						|
        )
 | 
						|
 | 
						|
    @stability_mode("database/dup,http")
 | 
						|
    def test_multiple_stability_database_dup_http_stable_modes(self):
 | 
						|
        self.assertEqual(
 | 
						|
            _OpenTelemetrySemanticConventionStability._get_opentelemetry_stability_opt_in_mode(
 | 
						|
                _OpenTelemetryStabilitySignalType.DATABASE
 | 
						|
            ),
 | 
						|
            _StabilityMode.DATABASE_DUP,
 | 
						|
        )
 | 
						|
        self.assertEqual(
 | 
						|
            _OpenTelemetrySemanticConventionStability._get_opentelemetry_stability_opt_in_mode(
 | 
						|
                _OpenTelemetryStabilitySignalType.HTTP
 | 
						|
            ),
 | 
						|
            _StabilityMode.HTTP,
 | 
						|
        )
 | 
						|
 | 
						|
    @stability_mode("database,database/dup,http,http/dup")
 | 
						|
    def test_stability_mode_dup_precedence(self):
 | 
						|
        self.assertEqual(
 | 
						|
            _OpenTelemetrySemanticConventionStability._get_opentelemetry_stability_opt_in_mode(
 | 
						|
                _OpenTelemetryStabilitySignalType.DATABASE
 | 
						|
            ),
 | 
						|
            _StabilityMode.DATABASE_DUP,
 | 
						|
        )
 | 
						|
        self.assertEqual(
 | 
						|
            _OpenTelemetrySemanticConventionStability._get_opentelemetry_stability_opt_in_mode(
 | 
						|
                _OpenTelemetryStabilitySignalType.HTTP
 | 
						|
            ),
 | 
						|
            _StabilityMode.HTTP_DUP,
 | 
						|
        )
 | 
						|
 | 
						|
 | 
						|
class TestOpenTelemetrySemConvStabilityHTTP(TestCase):
 | 
						|
    def test_set_status_for_non_http_code_with_recording_span(self):
 | 
						|
        span = Mock()
 | 
						|
        span.is_recording.return_value = True
 | 
						|
        metric_attributes = {}
 | 
						|
        _set_status(
 | 
						|
            span,
 | 
						|
            metric_attributes,
 | 
						|
            -1,
 | 
						|
            "Exception",
 | 
						|
            sem_conv_opt_in_mode=_StabilityMode.DEFAULT,
 | 
						|
        )
 | 
						|
 | 
						|
        self.assertIsNone(metric_attributes.get("error.type"))
 | 
						|
        span.set_attribute.assert_not_called()
 | 
						|
        status_call = span.set_status.call_args[0][0]
 | 
						|
        self.assertEqual(status_call.status_code, StatusCode.ERROR)
 | 
						|
        self.assertEqual(
 | 
						|
            status_call.description, "Non-integer HTTP status: " + "Exception"
 | 
						|
        )
 | 
						|
 | 
						|
    def test_status_code_http_default(self):
 | 
						|
        span = Mock()
 | 
						|
        metrics_attributes = {}
 | 
						|
        _set_status(
 | 
						|
            span=span,
 | 
						|
            metrics_attributes=metrics_attributes,
 | 
						|
            status_code=404,
 | 
						|
            status_code_str="404",
 | 
						|
            server_span=True,
 | 
						|
            sem_conv_opt_in_mode=_StabilityMode.DEFAULT,
 | 
						|
        )
 | 
						|
        # Verify only old conventions are emitted
 | 
						|
        span.set_attribute.assert_called_with("http.status_code", 404)
 | 
						|
        self.assertIn("http.status_code", metrics_attributes)
 | 
						|
        self.assertNotIn("http.response_status_code", metrics_attributes)
 | 
						|
 | 
						|
    def test_status_code_http_stable(self):
 | 
						|
        span = Mock()
 | 
						|
        metrics_attributes = {}
 | 
						|
        _set_status(
 | 
						|
            span=span,
 | 
						|
            metrics_attributes=metrics_attributes,
 | 
						|
            status_code=200,
 | 
						|
            status_code_str="200",
 | 
						|
            server_span=True,
 | 
						|
            sem_conv_opt_in_mode=_StabilityMode.HTTP,
 | 
						|
        )
 | 
						|
        # Verify only new conventions are emitted
 | 
						|
        span.set_attribute.assert_called_with("http.response.status_code", 200)
 | 
						|
        self.assertIn("http.response.status_code", metrics_attributes)
 | 
						|
        self.assertNotIn("http.status_code", metrics_attributes)
 | 
						|
 | 
						|
    def test_status_code_http_dup(self):
 | 
						|
        span = Mock()
 | 
						|
        metrics_attributes = {}
 | 
						|
        _set_status(
 | 
						|
            span=span,
 | 
						|
            metrics_attributes=metrics_attributes,
 | 
						|
            status_code=500,
 | 
						|
            status_code_str="500",
 | 
						|
            server_span=True,
 | 
						|
            sem_conv_opt_in_mode=_StabilityMode.HTTP_DUP,
 | 
						|
        )
 | 
						|
        # Verify both old and new conventions are emitted
 | 
						|
        span.set_attribute.assert_any_call("http.status_code", 500)
 | 
						|
        span.set_attribute.assert_any_call("http.response.status_code", 500)
 | 
						|
        self.assertIn("http.status_code", metrics_attributes)
 | 
						|
        self.assertIn("http.response.status_code", metrics_attributes)
 | 
						|
 | 
						|
    def test_error_status_code_new_mode(self):
 | 
						|
        span = Mock()
 | 
						|
        metrics_attributes = {}
 | 
						|
        _set_status(
 | 
						|
            span=span,
 | 
						|
            metrics_attributes=metrics_attributes,
 | 
						|
            status_code=500,
 | 
						|
            status_code_str="500",
 | 
						|
            server_span=True,
 | 
						|
            sem_conv_opt_in_mode=_StabilityMode.HTTP,
 | 
						|
        )
 | 
						|
        # Verify error type is set for new conventions
 | 
						|
        span.set_attribute.assert_any_call("error.type", "500")
 | 
						|
        self.assertIn("error.type", metrics_attributes)
 | 
						|
        self.assertEqual(metrics_attributes["error.type"], "500")
 | 
						|
 | 
						|
    def test_non_recording_span(self):
 | 
						|
        span = Mock()
 | 
						|
        span.is_recording.return_value = False
 | 
						|
        metrics_attributes = {}
 | 
						|
        _set_status(
 | 
						|
            span=span,
 | 
						|
            metrics_attributes=metrics_attributes,
 | 
						|
            status_code=200,
 | 
						|
            status_code_str="200",
 | 
						|
            server_span=True,
 | 
						|
            sem_conv_opt_in_mode=_StabilityMode.HTTP_DUP,
 | 
						|
        )
 | 
						|
        # Verify no span attributes are set if not recording
 | 
						|
        span.set_attribute.assert_not_called()
 | 
						|
        span.set_status.assert_not_called()
 | 
						|
        # Verify status code set for metrics independent of tracing decision
 | 
						|
        self.assertIn("http.status_code", metrics_attributes)
 | 
						|
        self.assertIn("http.response.status_code", metrics_attributes)
 |