[Tests] Add basic UserEvents scenario

Author: mdh1418

src/tests/tracing/userevents/README.md

@@ -4,7 +4,7 @@ This directory contains **functional tests** for the .NET user_events scenario.
 
 ## High-level Test Flow
 
-Each scenario uses the same pattern:
+Each scenario (for example, `basic`) uses the same pattern:
 
 1. **Scenario invokes the shared test runner**
 
@@ -26,4 +26,4 @@ Each scenario uses the same pattern:
   - `<scenario>.csproj` - Project file for the scenario.
   - `<scenario>.script` - `record-trace` script that configures how to collect the trace for the scenario.
 
-Each scenario reuses the common runner and shared `record-trace` deployable instead of duplicating binaries or orchestration logic.
+Each scenario reuses the common runner and shared `record-trace` deployable instead of duplicating binaries or orchestration logic. The `basic` scenario serves as a concrete example of how to add additional scenarios.

src/tests/tracing/userevents/basic/basic.cs

@@ -0,0 +1,64 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using System;
+using System.Diagnostics;
+using System.Threading;
+using Tracing.UserEvents.Tests.Common;
+using Microsoft.Diagnostics.Tracing;
+
+namespace Tracing.UserEvents.Tests.Basic
+{
+    public class Basic
+    {
+        private static byte[] s_array;
+
+        public static void BasicTracee()
+        {
+            long startTimestamp = Stopwatch.GetTimestamp();
+            long targetTicks = Stopwatch.Frequency; // 1s
+
+            while (Stopwatch.GetTimestamp() - startTimestamp < targetTicks)
+            {
+                s_array = new byte[1024 * 100];
+                Thread.Sleep(100);
+            }
+        }
+
+        private readonly static Func<EventPipeEventSource, bool> s_traceValidator = source =>
+        {
+            bool allocationSampledEventFound = false;
+
+            source.Dynamic.All += (TraceEvent e) =>
+            {
+                if (e.ProviderName == "Microsoft-Windows-DotNETRuntime")
+                {
+                    // TraceEvent's ClrTraceEventParser does not know about the AllocationSampled Event, so it shows up as "Unknown(303)"
+                    if (e.EventName.StartsWith("Unknown") && e.ID == (TraceEventID)303)
+                    {
+                        allocationSampledEventFound = true;
+                    }
+                }
+            };
+
+            source.Process();
+
+            if (!allocationSampledEventFound)
+            {
+                Console.Error.WriteLine("The trace did not contain an AllocationSampled event.");
+            }
+            return allocationSampledEventFound;
+        };
+
+        public static int Main(string[] args)
+        {
+            if (args.Length > 0 && args[0].Equals("tracee", StringComparison.OrdinalIgnoreCase))
+            {
+                BasicTracee();
+                return 0;
+            }
+
+            return UserEventsTestRunner.Run("basic", typeof(Basic).Assembly.Location, s_traceValidator);
+        }
+    }
+}

src/tests/tracing/userevents/basic/basic.csproj

@@ -0,0 +1,19 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <CLRTestTargetUnsupported Condition="'$(TargetOS)' != 'linux' or ('$(TargetArchitecture)' != 'x64' and '$(TargetArchitecture)' != 'arm64')">true</CLRTestTargetUnsupported>
+    <RequiresProcessIsolation>true</RequiresProcessIsolation>
+    <ReferenceXUnitWrapperGenerator>false</ReferenceXUnitWrapperGenerator>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <Compile Include="$(MSBuildProjectName).cs" />
+    <ProjectReference Include="../common/userevents_common.csproj" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <Content Include="basic.script">
+      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+      <TargetPath>basic.script</TargetPath>
+    </Content>
+  </ItemGroup>
+</Project>

src/tests/tracing/userevents/basic/basic.script

@@ -0,0 +1,2 @@
+let Microsoft_Windows_DotNETRuntime_flags = new_dotnet_provider_flags();
+record_dotnet_provider("Microsoft-Windows-DotNETRuntime", 0x80000000000, 4, Microsoft_Windows_DotNETRuntime_flags);