287 lines
12 KiB
C#
287 lines
12 KiB
C#
// <copyright file="SqlEventSourceTests.netfx.cs" company="OpenTelemetry Authors">
|
|
// 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.
|
|
// </copyright>
|
|
#if NETFRAMEWORK
|
|
using System;
|
|
using System.Data;
|
|
using System.Data.SqlClient;
|
|
using System.Diagnostics;
|
|
using System.Diagnostics.Tracing;
|
|
using System.Linq;
|
|
using System.Threading.Tasks;
|
|
using Moq;
|
|
using OpenTelemetry.Instrumentation.Dependencies.Implementation;
|
|
using OpenTelemetry.Internal.Test;
|
|
using OpenTelemetry.Trace;
|
|
using OpenTelemetry.Trace.Configuration;
|
|
using OpenTelemetry.Trace.Export;
|
|
using Xunit;
|
|
|
|
namespace OpenTelemetry.Instrumentation.Dependencies.Tests
|
|
{
|
|
public class SqlEventSourceTests
|
|
{
|
|
/*
|
|
To run the integration tests, set the OTEL_SQLCONNECTIONSTRING machine-level environment variable to a valid Sql Server connection string.
|
|
|
|
To use Docker...
|
|
1) Run: docker run -d --name sql2019 -e "ACCEPT_EULA=Y" -e "SA_PASSWORD=Pass@word" -p 5433:1433 mcr.microsoft.com/mssql/server:2019-latest
|
|
2) Set OTEL_SQLCONNECTIONSTRING as: Data Source=127.0.0.1,5433; User ID=sa; Password=Pass@word
|
|
*/
|
|
|
|
private const string SqlConnectionStringEnvVarName = "OTEL_SQLCONNECTIONSTRING";
|
|
private static readonly string SqlConnectionString = SkipUnlessEnvVarFoundTheoryAttribute.GetEnvironmentVariable(SqlConnectionStringEnvVarName);
|
|
|
|
[Trait("CategoryName", "SqlIntegrationTests")]
|
|
[SkipUnlessEnvVarFoundTheory(SqlConnectionStringEnvVarName)]
|
|
[InlineData(CommandType.Text, "select 1/1", false)]
|
|
[InlineData(CommandType.Text, "select 1/0", false, true)]
|
|
[InlineData(CommandType.StoredProcedure, "sp_who", false)]
|
|
[InlineData(CommandType.StoredProcedure, "sp_who", true)]
|
|
public async Task SuccessfulCommandTest(CommandType commandType, string commandText, bool captureText, bool isFailure = false)
|
|
{
|
|
var activityProcessor = new Mock<ActivityProcessor>();
|
|
using var shutdownSignal = OpenTelemetrySdk.EnableOpenTelemetry(b =>
|
|
{
|
|
b.AddProcessorPipeline(c => c.AddProcessor(ap => activityProcessor.Object));
|
|
b.AddSqlClientDependencyInstrumentation(options =>
|
|
{
|
|
options.SetStoredProcedureCommandName = captureText;
|
|
});
|
|
});
|
|
|
|
using SqlConnection sqlConnection = new SqlConnection(SqlConnectionString);
|
|
|
|
await sqlConnection.OpenAsync().ConfigureAwait(false);
|
|
|
|
string dataSource = sqlConnection.DataSource;
|
|
|
|
sqlConnection.ChangeDatabase("master");
|
|
|
|
using SqlCommand sqlCommand = new SqlCommand(commandText, sqlConnection)
|
|
{
|
|
CommandType = commandType,
|
|
};
|
|
|
|
try
|
|
{
|
|
await sqlCommand.ExecuteNonQueryAsync().ConfigureAwait(false);
|
|
}
|
|
catch
|
|
{
|
|
}
|
|
|
|
Assert.Equal(2, activityProcessor.Invocations.Count);
|
|
|
|
var activity = (Activity)activityProcessor.Invocations[1].Arguments[0];
|
|
|
|
VerifyActivityData(commandType, commandText, captureText, isFailure, dataSource, activity);
|
|
}
|
|
|
|
[Theory]
|
|
[InlineData(CommandType.Text, "select 1/1", false)]
|
|
[InlineData(CommandType.Text, "select 1/0", false, true)]
|
|
[InlineData(CommandType.StoredProcedure, "sp_who", false)]
|
|
[InlineData(CommandType.StoredProcedure, "sp_who", true, false, 0, true)]
|
|
public void EventSourceFakeTests(
|
|
CommandType commandType,
|
|
string commandText,
|
|
bool captureText,
|
|
bool isFailure = false,
|
|
int sqlExceptionNumber = 0,
|
|
bool enableConnectionLevelAttributes = false)
|
|
{
|
|
using FakeBehavingSqlEventSource fakeSqlEventSource = new FakeBehavingSqlEventSource();
|
|
|
|
var activityProcessor = new Mock<ActivityProcessor>();
|
|
using var shutdownSignal = OpenTelemetrySdk.EnableOpenTelemetry(b =>
|
|
{
|
|
b.AddProcessorPipeline(c => c.AddProcessor(ap => activityProcessor.Object));
|
|
b.AddSqlClientDependencyInstrumentation(options =>
|
|
{
|
|
options.SetStoredProcedureCommandName = captureText;
|
|
options.EnableConnectionLevelAttributes = enableConnectionLevelAttributes;
|
|
});
|
|
});
|
|
|
|
int objectId = Guid.NewGuid().GetHashCode();
|
|
|
|
fakeSqlEventSource.WriteBeginExecuteEvent(objectId, "127.0.0.1", "master", commandType == CommandType.StoredProcedure ? commandText : string.Empty);
|
|
|
|
// success is stored in the first bit in compositeState 0b001
|
|
int successFlag = !isFailure ? 1 : 0;
|
|
|
|
// isSqlException is stored in the second bit in compositeState 0b010
|
|
int isSqlExceptionFlag = sqlExceptionNumber > 0 ? 2 : 0;
|
|
|
|
// synchronous state is stored in the third bit in compositeState 0b100
|
|
int synchronousFlag = false ? 4 : 0;
|
|
|
|
int compositeState = successFlag | isSqlExceptionFlag | synchronousFlag;
|
|
|
|
fakeSqlEventSource.WriteEndExecuteEvent(objectId, compositeState, sqlExceptionNumber);
|
|
|
|
Assert.Equal(2, activityProcessor.Invocations.Count);
|
|
|
|
var activity = (Activity)activityProcessor.Invocations[1].Arguments[0];
|
|
|
|
VerifyActivityData(commandType, commandText, captureText, isFailure, "127.0.0.1", activity, enableConnectionLevelAttributes);
|
|
}
|
|
|
|
[Fact]
|
|
public void EventSourceFakeUnknownEventWithNullPayloadTest()
|
|
{
|
|
using FakeMisbehavingSqlEventSource fakeSqlEventSource = new FakeMisbehavingSqlEventSource();
|
|
|
|
var activityProcessor = new Mock<ActivityProcessor>();
|
|
using var shutdownSignal = OpenTelemetrySdk.EnableOpenTelemetry(b =>
|
|
{
|
|
b.AddProcessorPipeline(c => c.AddProcessor(ap => activityProcessor.Object));
|
|
b.AddSqlClientDependencyInstrumentation();
|
|
});
|
|
|
|
fakeSqlEventSource.WriteUnknownEventWithNullPayload();
|
|
|
|
Assert.Equal(0, activityProcessor.Invocations.Count);
|
|
}
|
|
|
|
[Fact]
|
|
public void EventSourceFakeInvalidPayloadTest()
|
|
{
|
|
using FakeMisbehavingSqlEventSource fakeSqlEventSource = new FakeMisbehavingSqlEventSource();
|
|
|
|
var activityProcessor = new Mock<ActivityProcessor>();
|
|
using var shutdownSignal = OpenTelemetrySdk.EnableOpenTelemetry(b =>
|
|
{
|
|
b.AddProcessorPipeline(c => c.AddProcessor(ap => activityProcessor.Object));
|
|
b.AddSqlClientDependencyInstrumentation();
|
|
});
|
|
|
|
fakeSqlEventSource.WriteBeginExecuteEvent("arg1");
|
|
|
|
fakeSqlEventSource.WriteEndExecuteEvent("arg1", "arg2", "arg3", "arg4");
|
|
|
|
Assert.Equal(0, activityProcessor.Invocations.Count);
|
|
}
|
|
|
|
private static void VerifyActivityData(
|
|
CommandType commandType,
|
|
string commandText,
|
|
bool captureText,
|
|
bool isFailure,
|
|
string dataSource,
|
|
Activity activity,
|
|
bool enableConnectionLevelAttributes = false)
|
|
{
|
|
Assert.Equal("master", activity.DisplayName);
|
|
Assert.Equal(ActivityKind.Client, activity.Kind);
|
|
Assert.Equal(SqlClientDiagnosticListener.MicrosoftSqlServerDatabaseSystemName, activity.Tags.FirstOrDefault(t => t.Key == SemanticConventions.AttributeDBSystem).Value);
|
|
|
|
if (!enableConnectionLevelAttributes)
|
|
{
|
|
Assert.Equal(dataSource, activity.Tags.FirstOrDefault(t => t.Key == SemanticConventions.AttributePeerService).Value);
|
|
}
|
|
else
|
|
{
|
|
var connectionDetails = SqlClientInstrumentationOptions.ParseDataSource(dataSource);
|
|
|
|
if (!string.IsNullOrEmpty(connectionDetails.ServerHostName))
|
|
{
|
|
Assert.Equal(connectionDetails.ServerHostName, activity.Tags.FirstOrDefault(t => t.Key == SemanticConventions.AttributeNetPeerName).Value);
|
|
}
|
|
else
|
|
{
|
|
Assert.Equal(connectionDetails.ServerIpAddress, activity.Tags.FirstOrDefault(t => t.Key == SemanticConventions.AttributeNetPeerIP).Value);
|
|
}
|
|
|
|
if (!string.IsNullOrEmpty(connectionDetails.InstanceName))
|
|
{
|
|
Assert.Equal(connectionDetails.InstanceName, activity.Tags.FirstOrDefault(t => t.Key == SemanticConventions.AttributeDBMSSQLInstanceName).Value);
|
|
}
|
|
|
|
if (!string.IsNullOrEmpty(connectionDetails.Port))
|
|
{
|
|
Assert.Equal(connectionDetails.Port, activity.Tags.FirstOrDefault(t => t.Key == SemanticConventions.AttributeNetPeerPort).Value);
|
|
}
|
|
}
|
|
|
|
Assert.Equal("master", activity.Tags.FirstOrDefault(t => t.Key == SemanticConventions.AttributeDBName).Value);
|
|
Assert.Equal(commandType.ToString(), activity.Tags.FirstOrDefault(t => t.Key == SpanAttributeConstants.DatabaseStatementTypeKey).Value);
|
|
if (commandType == CommandType.StoredProcedure)
|
|
{
|
|
if (captureText)
|
|
{
|
|
Assert.Equal(commandText, activity.Tags.FirstOrDefault(t => t.Key == SemanticConventions.AttributeDBStatement).Value);
|
|
}
|
|
else
|
|
{
|
|
Assert.DoesNotContain(activity.Tags, t => t.Key == SemanticConventions.AttributeDBStatement);
|
|
}
|
|
}
|
|
|
|
if (!isFailure)
|
|
{
|
|
Assert.Equal("Ok", activity.Tags.FirstOrDefault(t => t.Key == SpanAttributeConstants.StatusCodeKey).Value);
|
|
}
|
|
else
|
|
{
|
|
Assert.Equal("Unknown", activity.Tags.FirstOrDefault(t => t.Key == SpanAttributeConstants.StatusCodeKey).Value);
|
|
Assert.Contains(activity.Tags, t => t.Key == SpanAttributeConstants.StatusDescriptionKey);
|
|
}
|
|
}
|
|
|
|
[EventSource(Name = SqlEventSourceListener.AdoNetEventSourceName + "-FakeFriendly")]
|
|
private class FakeBehavingSqlEventSource : EventSource
|
|
{
|
|
[Event(SqlEventSourceListener.BeginExecuteEventId)]
|
|
public void WriteBeginExecuteEvent(int objectId, string dataSource, string databaseName, string commandText)
|
|
{
|
|
this.WriteEvent(SqlEventSourceListener.BeginExecuteEventId, objectId, dataSource, databaseName, commandText);
|
|
}
|
|
|
|
[Event(SqlEventSourceListener.EndExecuteEventId)]
|
|
public void WriteEndExecuteEvent(int objectId, int compositeState, int sqlExceptionNumber)
|
|
{
|
|
this.WriteEvent(SqlEventSourceListener.EndExecuteEventId, objectId, compositeState, sqlExceptionNumber);
|
|
}
|
|
}
|
|
|
|
[EventSource(Name = SqlEventSourceListener.AdoNetEventSourceName + "-FakeEvil")]
|
|
private class FakeMisbehavingSqlEventSource : EventSource
|
|
{
|
|
[Event(SqlEventSourceListener.BeginExecuteEventId)]
|
|
public void WriteBeginExecuteEvent(string arg1)
|
|
{
|
|
this.WriteEvent(SqlEventSourceListener.BeginExecuteEventId, arg1);
|
|
}
|
|
|
|
[Event(SqlEventSourceListener.EndExecuteEventId)]
|
|
public void WriteEndExecuteEvent(string arg1, string arg2, string arg3, string arg4)
|
|
{
|
|
this.WriteEvent(SqlEventSourceListener.EndExecuteEventId, arg1, arg2, arg3, arg4);
|
|
}
|
|
|
|
[Event(3)]
|
|
public void WriteUnknownEventWithNullPayload()
|
|
{
|
|
object[] args = null;
|
|
|
|
this.WriteEvent(3, args);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
#endif
|