private void SynchronizedMetricRegistration()
{
string name = Thread.CurrentThread.Name;
Trace.TraceInformation("{0} started", name);
EventMetricDefinition newDefinition = new EventMetricDefinition("EventMetricTests", "Gibraltar.Monitor.Test", "Sync");
newDefinition.AddValue("delta", typeof(double), SummaryFunction.RunningSum, null, "Delta", "The applied delta");
try
{
Interlocked.Increment(ref m_ThreadCounter);
lock (m_SyncLock)
{
// Do nothing, just release it immediately.
}
EventMetricDefinition.Register(ref newDefinition);
EventMetric metric = EventMetric.Register(newDefinition, name);
Trace.TraceInformation("{0} completed registration of event metric", name);
EventMetricSample sample = metric.CreateSample();
sample.SetValue("delta", Thread.CurrentThread.ManagedThreadId);
sample.Write();
}
catch (Exception ex)
{
m_ThreadFailed = true;
Trace.TraceError("{0} got {1}: {2}", name, ex.GetType().Name, ex.Message, ex);
}
Interlocked.Decrement(ref m_ThreadCounter);
}
/// <summary>
/// Record an event metric using a programmatic declaration
/// </summary>
/// <param name="pagesLoaded"></param>
public static void RecordCacheMetric(int pagesLoaded)
{
EventMetricDefinition cacheMetric;
//so we can be called multiple times we want to see if the definition already exists.
if (EventMetricDefinition.TryGetValue("GibraltarSample", "Database.Engine", "Cache", out cacheMetric) == false)
{
cacheMetric = new EventMetricDefinition("GibraltarSample", "Database.Engine", "Cache");
//add the values (that are part of the definition)
cacheMetric.AddValue("pages", typeof(int), SummaryFunction.Average, "Pages", "Pages in Cache", "Total number of pages in cache");
cacheMetric.AddValue("size", typeof(int), SummaryFunction.Average, "Bytes", "Cache Size", "Total number of bytes used by pages in cache");
//and now that we're done, we need to register this definition. This locks the definition
//and makes it go live. Note that it's based by ref because if another thread registered the same metric, we'll get the
//registered object (whoever one the race), not necessarily the one we've just created to pass in.
EventMetricDefinition.Register(ref cacheMetric);
}
//Now we can get the specific metric we want to record samples under (this is an instance of the definition)
EventMetric cacheEventMetric = EventMetric.Register(cacheMetric, null);
//now go ahead and write that sample.
EventMetricSample newSample = cacheEventMetric.CreateSample();
newSample.SetValue("pages", pagesLoaded);
newSample.SetValue("size", pagesLoaded * 8196);
newSample.Write();
}
public void EventMetricsByMethodsPerformanceTest()
{
EventMetricDefinition eventDefinition;
if (false == EventMetricDefinition.TryGetValue("PerformanceTestsMetrics", "Performance.EventMetrics.Methods", "UserEvent", out eventDefinition))
{
eventDefinition = new EventMetricDefinition("PerformanceTestsMetrics", "Performance.EventMetrics.Methods", "UserEvent");
eventDefinition.Caption = "User Event";
eventDefinition.Description = "Unit test event metric with typical data.";
eventDefinition.AddValue("fileName", typeof(string), SummaryFunction.Count, null, "File name", "The name of the file");
eventDefinition.AddValue("operation", typeof(UserFileOperation), SummaryFunction.Count, null, "Operation", "The type of file operation being performed.");
eventDefinition.AddValue("duration", typeof(TimeSpan), SummaryFunction.Average, "ms", "Duration", "The duration for this file operation.");
EventMetricDefinition.Register(ref eventDefinition, "duration");
}
Assert.IsNotNull(eventDefinition);
Assert.IsTrue(eventDefinition.IsReadOnly);
Trace.TraceInformation("Event metric definition registered by methods.");
EventMetric eventMetric = EventMetric.Register(eventDefinition, "MethodsPerformanceTest");
Assert.IsNotNull(eventMetric);
string fileName = @"C:\Dummy\File\Name.txt";
DateTimeOffset operationStart = DateTimeOffset.UtcNow;
DateTimeOffset operationEnd = operationStart.AddMilliseconds(1234);
//first, lets get everything to flush so we have our best initial state.
Log.Information(LogWriteMode.WaitForCommit, "Test.Agent.Metrics.Performance", "Preparing for Test", "Flushing queue");
//now that we know it's flushed everything, lets do our timed loop.
DateTimeOffset startTime = DateTimeOffset.UtcNow;
for (int curMessage = 0; curMessage < LoopsPerEventTest; curMessage++)
{
EventMetricSample eventSample = eventMetric.CreateSample();
eventSample.SetValue("fileName", fileName);
eventSample.SetValue("operation", UserFileOperation.Write);
eventSample.SetValue("duration", operationEnd - operationStart);
eventSample.Write();
}
DateTimeOffset messageEndTime = DateTimeOffset.UtcNow;
//one wait for commit message to force the buffer to flush.
Log.Information(LogWriteMode.WaitForCommit, "Test.Agent.Metrics.Performance", "Waiting for Samples to Commit", null);
//and store off our time
DateTimeOffset endTime = DateTimeOffset.UtcNow;
TimeSpan testDuration = endTime - startTime;
TimeSpan loopDuration = messageEndTime - startTime;
const int messagesPerTest = LoopsPerEventTest * MessagesPerEventLoop;
Trace.TraceInformation("Event Metrics by Methods Test committed {0:N0} events in {1:F3} ms (average {2:F4} ms per message). Average loop time {3:F4} ms ({4} values per message) and final flush time {5:F3} ms.",
messagesPerTest, testDuration.TotalMilliseconds, (testDuration.TotalMilliseconds / messagesPerTest),
(loopDuration.TotalMilliseconds / LoopsPerEventTest), ValuesPerEventMessage,
(endTime - messageEndTime).TotalMilliseconds);
}
private void StopAndRecordMetric()
{
//record our end time
if (m_Timer == null)
{
m_Duration = new TimeSpan(0);
}
else
{
m_Timer.Stop();
m_Duration = m_Timer.Elapsed;
}
//Get the METRIC DEFINITION
IMetricDefinition metricDefinition;
EventMetricDefinition eventDefinition;
if (Log.Metrics.TryGetValue(MetricTypeName, m_Category, MetricCounterName, out metricDefinition) == false)
{
//it doesn't exist yet - add it
eventDefinition = new EventMetricDefinition(MetricTypeName, m_Category, MetricCounterName);
eventDefinition.Description = MetricDefinitionDescription;
EventMetricValueDefinitionCollection valueDefinitionCollection = (EventMetricValueDefinitionCollection)eventDefinition.Values;
valueDefinitionCollection.Add("operationname", typeof(string), "Operation Name", "The operation that was executed.");
valueDefinitionCollection.Add("duration", typeof(TimeSpan), "Duration", "The duration the operation executed.");
((EventMetricValueDefinition)eventDefinition.Values["duration"]).UnitCaption = "Milliseconds";
eventDefinition.DefaultValue = eventDefinition.Values["duration"];
//and don't forget to register it!
eventDefinition = eventDefinition.Register();
}
else
{
eventDefinition = (EventMetricDefinition)metricDefinition;
}
//Get the METRIC
IMetric metric;
EventMetric eventMetric;
if (eventDefinition.Metrics.TryGetValue(null, out metric) == false)
{
eventMetric = new EventMetric(eventDefinition, (string)null);
}
else
{
eventMetric = (EventMetric)metric;
}
//and finally we can RECORD THE SAMPLE.
EventMetricSample metricSample = eventMetric.CreateSample();
metricSample.SetValue("operationname", OperationName);
metricSample.SetValue("duration", Duration);
metricSample.Write();
}
public void Setup()
{
IMetricDefinition newMetricDefinition;
EventMetricDefinition newEventMetricDefinition;
// See if we already created the event metric we need
if (Log.Metrics.TryGetValue("GeneralMetricCollectionTests", "Gibraltar.Monitor.Test", "Manual", out newMetricDefinition) == false)
{
// Didn't find it, so define an event metric manually (the hard way)
newEventMetricDefinition = new EventMetricDefinition("GeneralMetricCollectionTests", "Gibraltar.Monitor.Test", "Manual");
newMetricDefinition = newEventMetricDefinition; // cast it as the base type, too
// we now have a minimal definition, but we probably want to add a few attributes to make it useful
// NOTE: This is designed to exactly match UserDataObject for convenience in analzing results.
EventMetricValueDefinitionCollection valueDefinitions = (EventMetricValueDefinitionCollection)newEventMetricDefinition.Values;
valueDefinitions.Add("short_average", typeof(short), "Short Average", "Data of type Short").DefaultTrend = EventMetricValueTrend.Average;
valueDefinitions.Add("short_sum", typeof(short), "Short Sum", "Data of type Short").DefaultTrend = EventMetricValueTrend.Sum;
valueDefinitions.Add("ushort_average", typeof(ushort), "UShort Average", "Data of type UShort").DefaultTrend = EventMetricValueTrend.Average;
valueDefinitions.Add("ushort_sum", typeof(ushort), "UShort Sum", "Data of type UShort").DefaultTrend = EventMetricValueTrend.Sum;
valueDefinitions.Add("int_average", typeof(int), "Int Average", "Data of type Int").DefaultTrend = EventMetricValueTrend.Average;
valueDefinitions.Add("int_sum", typeof(int), "Int Sum", "Data of type Int").DefaultTrend = EventMetricValueTrend.Sum;
valueDefinitions.Add("uint_average", typeof(uint), "UInt Average", "Data of type UInt").DefaultTrend = EventMetricValueTrend.Average;
valueDefinitions.Add("uint_sum", typeof(uint), "UInt Sum", "Data of type UInt").DefaultTrend = EventMetricValueTrend.Sum;
valueDefinitions.Add("long_average", typeof(long), "Long Average", "Data of type Long").DefaultTrend = EventMetricValueTrend.Average;
valueDefinitions.Add("long_sum", typeof(long), "Long Sum", "Data of type Long").DefaultTrend = EventMetricValueTrend.Sum;
valueDefinitions.Add("ulong_average", typeof(ulong), "ULong Average", "Data of type ULong").DefaultTrend = EventMetricValueTrend.Average;
valueDefinitions.Add("ulong_sum", typeof(ulong), "ULong Sum", "Data of type ULong").DefaultTrend = EventMetricValueTrend.Sum;
valueDefinitions.Add("decimal_average", typeof(decimal), "Decimal Average", "Data of type Decimal").DefaultTrend = EventMetricValueTrend.Average;
valueDefinitions.Add("decimal_sum", typeof(decimal), "Decimal Sum", "Data of type Decimal").DefaultTrend = EventMetricValueTrend.Sum;
valueDefinitions.Add("double_average", typeof(double), "Double Average", "Data of type Double").DefaultTrend = EventMetricValueTrend.Average;
valueDefinitions.Add("double_sum", typeof(double), "Double Sum", "Data of type Double").DefaultTrend = EventMetricValueTrend.Sum;
valueDefinitions.Add("float_average", typeof(float), "Float Average", "Data of type Float").DefaultTrend = EventMetricValueTrend.Average;
valueDefinitions.Add("float_sum", typeof(float), "Float Sum", "Data of type Float").DefaultTrend = EventMetricValueTrend.Sum;
valueDefinitions.Add("string", typeof(string), "String", "Data of type String");
valueDefinitions.Add("system.enum", typeof(System.Enum), "System.Enum", "Data of type System.Enum");
newEventMetricDefinition.DefaultValue = newEventMetricDefinition.Values["int_average"];
newEventMetricDefinition = newEventMetricDefinition.Register(); // Register it with the collection.
}
else
{
// Found one, try to cast it to the expected EventMetricDefinition type (raise exception if fails to match)
newEventMetricDefinition = (EventMetricDefinition)newMetricDefinition;
}
IMetric newMetric;
if (newMetricDefinition.Metrics.TryGetValue(null, out newMetric) == false)
{
// go ahead and add this new metric
newMetric = new EventMetric(newEventMetricDefinition, (string)null); //add the default metric.
}
Assert.IsNotNull(newMetricDefinition);
Assert.IsNotNull(newEventMetricDefinition);
Assert.IsNotNull(newMetric);
}
public void Setup()
{
// This is an example of how to create an event metric definition programatically.
EventMetricDefinition newMetricDefinition;
// Define an event metric manually (the long way). First, see if it's already registered...
if (EventMetricDefinition.TryGetValue("EventMetricTests", "Gibraltar.Monitor.Test", "Manual", out newMetricDefinition) == false)
{
// It's not registered yet, so we need to fill out the template to define it.
EventMetricDefinition newEventMetric = new EventMetricDefinition("EventMetricTests", "Gibraltar.Monitor.Test", "Manual");
// Now we want to add a few value columns to make it useful.
// NOTE: This is designed to exactly match UserEventObject for convenience in analzing results.
// The dummy data values we're using are unitless, so we'll just use null for the required unitCaption parameter.
newEventMetric.AddValue("short_average", typeof(short), SummaryFunction.Average, null, "Short Average", "Data of type Short");
newEventMetric.AddValue("short_sum", typeof(short), SummaryFunction.Sum, null, "Short Sum", "Data of type Short");
newEventMetric.AddValue("short_runningaverage", typeof(short), SummaryFunction.RunningAverage, null, "Short Running Average", "Data of type Short");
newEventMetric.AddValue("short_runningsum", typeof(short), SummaryFunction.RunningSum, null, "Short Running Sum", "Data of type Short");
newEventMetric.AddValue("ushort_average", typeof(ushort), SummaryFunction.Average, null, "UShort Average", "Data of type UShort");
newEventMetric.AddValue("ushort_sum", typeof(ushort), SummaryFunction.Sum, null, "UShort Sum", "Data of type UShort");
// Pick an interesting value column as the default to be graphed for this metric. We'll pass it below.
EventMetricValueDefinition defaultValue =
newEventMetric.AddValue("int_average", typeof(int), SummaryFunction.Average, null, "Int Average", "Data of type Int");
newEventMetric.AddValue("int_sum", typeof(int), SummaryFunction.Sum, null, "Int Sum", "Data of type Int");
newEventMetric.AddValue("uint_average", typeof(uint), SummaryFunction.Average, null, "UInt Average", "Data of type UInt");
newEventMetric.AddValue("uint_sum", typeof(uint), SummaryFunction.Sum, null, "UInt Sum", "Data of type UInt");
newEventMetric.AddValue("long_average", typeof(long), SummaryFunction.Average, null, "Long Average", "Data of type Long");
newEventMetric.AddValue("long_sum", typeof(long), SummaryFunction.Sum, null, "Long Sum", "Data of type Long");
newEventMetric.AddValue("ulong_average", typeof(ulong), SummaryFunction.Average, null, "ULong Average", "Data of type ULong");
newEventMetric.AddValue("ulong_sum", typeof(ulong), SummaryFunction.Sum, null, "ULong Sum", "Data of type ULong");
newEventMetric.AddValue("decimal_average", typeof(decimal), SummaryFunction.Average, null, "Decimal Average", "Data of type Decimal");
newEventMetric.AddValue("decimal_sum", typeof(decimal), SummaryFunction.Sum, null, "Decimal Sum", "Data of type Decimal");
newEventMetric.AddValue("double_average", typeof(double), SummaryFunction.Average, null, "Double Average", "Data of type Double");
newEventMetric.AddValue("double_sum", typeof(double), SummaryFunction.Sum, null, "Double Sum", "Data of type Double");
newEventMetric.AddValue("float_average", typeof(float), SummaryFunction.Average, null, "Float Average", "Data of type Float");
newEventMetric.AddValue("float_sum", typeof(float), SummaryFunction.Sum, null, "Float Sum", "Data of type Float");
newEventMetric.AddValue("timespan_average", typeof(TimeSpan), SummaryFunction.Average, null, "TimeSpan Average", "Data of type TimeSpan");
newEventMetric.AddValue("timespan_sum", typeof(TimeSpan), SummaryFunction.Sum, null, "TimeSpan Sum", "Data of type TimeSpan");
newEventMetric.AddValue("timespan_runningaverage", typeof(TimeSpan), SummaryFunction.RunningAverage, null, "TimeSpan Running Average", "Data of type TimeSpan represented as a running average.");
newEventMetric.AddValue("timespan_runningsum", typeof(TimeSpan), SummaryFunction.RunningSum, null, "TimeSpan Running Sum", "Data of type TimeSpan represented as a running sum.");
newEventMetric.AddValue("string", typeof(string), SummaryFunction.Count, null, "String", "Data of type String");
newEventMetric.AddValue("system.enum", typeof(UserDataEnumeration), SummaryFunction.Count, null, "System.Enum", "Data of type System.Enum");
// Finally, register it with Gibraltar, and specify the default value column we saved above.
EventMetricDefinition.Register(ref newEventMetric, defaultValue);
}
EventMetricDefinition metricDefinition;
Assert.IsTrue(EventMetricDefinition.TryGetValue("EventMetricTests", "Gibraltar.Monitor.Test", "Manual", out metricDefinition));
Assert.IsNotNull(metricDefinition);
}
private static EventMetricDefinition DefineRequestMetric(string applicationName)
{
var definition = new EventMetricDefinition(applicationName, "AspNetCore", "Request");
definition.AddValue("request", typeof(string), SummaryFunction.Count, "Request", "Request",
"The query that was executed.");
definition.AddValue("duration", typeof(TimeSpan), SummaryFunction.Average, "Duration", "Duration",
"Time taken to execute the query");
definition.AddValue("error", typeof(string), SummaryFunction.Count, "Errors", "Errors",
"Errors executing query.");
EventMetricDefinition.Register(ref definition);
return(definition);
}
private static EventMetricDefinition DefineRequestMetric()
{
var definition = new EventMetricDefinition(Constants.LogSystem, Constants.MetricCategory, "Request");
definition.AddValue("request", typeof(string), SummaryFunction.Count, "Request", "Request",
"The query that was executed.");
definition.AddValue("duration", typeof(TimeSpan), SummaryFunction.Average, "Duration", "Duration",
"Time taken to execute the query");
definition.AddValue("error", typeof(string), SummaryFunction.Count, "Errors", "Errors",
"Errors executing query.");
EventMetricDefinition.Register(ref definition);
return(definition);
}
/// <summary>
/// Perform the one-time work to create a metric
/// </summary>
/// <param name="name">Dot-delimited display name for this metric</param>
private void InitializeMetric(string name)
{
// Handle edge cases
if (string.IsNullOrEmpty(name))
{
name = DefaultInstance;
}
name = name.Trim();
while (!string.IsNullOrEmpty(name) && name[0] == '.')
{
name = name.Substring(1).Trim();
}
// Set up category and instance as Loupe wants
string category;
string instance;
var pos = name.LastIndexOf('.'); // check for delimited name
if (pos <= 0)
{
// If not deliminated, just use base category
category = RootCategory;
instance = name;
}
else
{
// If delimited, just use the last part as instance name
// and combine the rest with category
category = RootCategory + '.' + name.Substring(0, pos);
instance = name.Substring(pos + 1);
}
_logCategory = category + "." + instance; // Initializ category for logging
EventMetricDefinition metricDefinition;
// Create the metric on first call then use cached copy thereafter
if (!EventMetricDefinition.TryGetValue(MetricSystem, category, instance, out metricDefinition))
{
metricDefinition = new EventMetricDefinition(MetricSystem, category, instance);
metricDefinition.AddValue(DurationCaption, typeof(TimeSpan), SummaryFunction.Average,
null, DurationCaption, null);
EventMetricDefinition.Register(ref metricDefinition);
}
// Grab the metric from cache
Metric = EventMetric.Register(metricDefinition, null);
}
public void Setup()
{
IMetricDefinition newMetricDefinition;
//Define an event metric manually (the long way)
if (Log.Metrics.TryGetValue("EventMetricTests", "Gibraltar.Monitor.Test", "Manual", out newMetricDefinition) == false)
{
//Define an event metric manually (the hard way)
EventMetricDefinition newEventMetric = new EventMetricDefinition("EventMetricTests", "Gibraltar.Monitor.Test", "Manual");
//we now have a minimal definition, but we probably want to add a few attributes to make it useful
//NOTE: This is designed to exactly match UserDataObject for convenience in analzing results.
EventMetricValueDefinitionCollection valueDefinition = (EventMetricValueDefinitionCollection)newEventMetric.Values;
valueDefinition.Add("short_average", typeof(short), "Short Average", "Data of type Short").DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.Add("short_sum", typeof(short), "Short Sum", "Data of type Short").DefaultTrend = EventMetricValueTrend.Sum;
valueDefinition.Add("short_runningaverage", typeof(short), "Short Running Average", "Data of type Short").DefaultTrend = EventMetricValueTrend.RunningAverage;
valueDefinition.Add("short_runningsum", typeof(short), "Short Running Sum", "Data of type Short").DefaultTrend = EventMetricValueTrend.RunningSum;
valueDefinition.Add("ushort_average", typeof(ushort), "UShort Average", "Data of type UShort").DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.Add("ushort_sum", typeof(ushort), "UShort Sum", "Data of type UShort").DefaultTrend = EventMetricValueTrend.Sum;
valueDefinition.Add("int_average", typeof(int), "Int Average", "Data of type Int").DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.Add("int_sum", typeof(int), "Int Sum", "Data of type Int").DefaultTrend = EventMetricValueTrend.Sum;
valueDefinition.Add("uint_average", typeof(uint), "UInt Average", "Data of type UInt").DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.Add("uint_sum", typeof(uint), "UInt Sum", "Data of type UInt").DefaultTrend = EventMetricValueTrend.Sum;
valueDefinition.Add("long_average", typeof(long), "Long Average", "Data of type Long").DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.Add("long_sum", typeof(long), "Long Sum", "Data of type Long").DefaultTrend = EventMetricValueTrend.Sum;
valueDefinition.Add("ulong_average", typeof(ulong), "ULong Average", "Data of type ULong").DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.Add("ulong_sum", typeof(ulong), "ULong Sum", "Data of type ULong").DefaultTrend = EventMetricValueTrend.Sum;
valueDefinition.Add("decimal_average", typeof(decimal), "Decimal Average", "Data of type Decimal").DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.Add("decimal_sum", typeof(decimal), "Decimal Sum", "Data of type Decimal").DefaultTrend = EventMetricValueTrend.Sum;
valueDefinition.Add("double_average", typeof(double), "Double Average", "Data of type Double").DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.Add("double_sum", typeof(double), "Double Sum", "Data of type Double").DefaultTrend = EventMetricValueTrend.Sum;
valueDefinition.Add("float_average", typeof(float), "Float Average", "Data of type Float").DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.Add("float_sum", typeof(float), "Float Sum", "Data of type Float").DefaultTrend = EventMetricValueTrend.Sum;
valueDefinition.Add("timespan_average", typeof(TimeSpan), "TimeSpan Average", "Data of type TimeSpan").DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.Add("timespan_sum", typeof(TimeSpan), "TimeSpan Sum", "Data of type TimeSpan").DefaultTrend = EventMetricValueTrend.Sum;
valueDefinition.Add("timespan_runningaverage", typeof(TimeSpan), "TimeSpan Running Average", "Data of type TimeSpan represented as a running average.").DefaultTrend = EventMetricValueTrend.RunningAverage;
valueDefinition.Add("timespan_runningsum", typeof(TimeSpan), "TimeSpan Running Sum", "Data of type TimeSpan represented as a running sum.").DefaultTrend = EventMetricValueTrend.RunningSum;
valueDefinition.Add("string", typeof(string), "String", "Data of type String");
valueDefinition.Add("system.enum", typeof(UserDataEnumeration), "System.Enum", "Data of type System.Enum");
newEventMetric.DefaultValue = newEventMetric.Values["int_average"];
newEventMetric.Register(); // Register it with the collection.
}
//And define a metric using reflection (not the same metric as above)
//UserDataObject myDataObject = new UserDataObject(null);
//EventMetric.AddOrGet(myDataObject);
}
public void RegisterEventMetrics()
{
//Define an event metric manually (the hard way)
EventMetricDefinition newEventMetric =
new EventMetricDefinition("EventMetricTests", "Gibraltar.Monitor.Test", "Manual");
//we now have a minimal definition, but we probably want to add a few attributes to make it useful
//NOTE: This is designed to exactly match UserDataObject for convenience in analyzing results.
EventMetricValueDefinitionCollection valueDefinition = (EventMetricValueDefinitionCollection)newEventMetric.Values;
valueDefinition.Add("short_average", typeof(short), "Short Average", "Data of type Short").DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.Add("short_sum", typeof(short), "Short Sum", "Data of type Short").DefaultTrend = EventMetricValueTrend.Sum;
valueDefinition.Add("short_runningaverage", typeof(short), "Short Running Average", "Data of type Short").DefaultTrend = EventMetricValueTrend.RunningAverage;
valueDefinition.Add("short_runningsum", typeof(short), "Short Running Sum", "Data of type Short").DefaultTrend = EventMetricValueTrend.RunningSum;
valueDefinition.Add("ushort_average", typeof(ushort), "UShort Average", "Data of type UShort").DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.Add("ushort_sum", typeof(ushort), "UShort Sum", "Data of type UShort").DefaultTrend = EventMetricValueTrend.Sum;
valueDefinition.Add("int_average", typeof(int), "Int Average", "Data of type Int").DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.Add("int_sum", typeof(int), "Int Sum", "Data of type Int").DefaultTrend = EventMetricValueTrend.Sum;
valueDefinition.Add("uint_average", typeof(uint), "UInt Average", "Data of type UInt").DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.Add("uint_sum", typeof(uint), "UInt Sum", "Data of type UInt").DefaultTrend = EventMetricValueTrend.Sum;
valueDefinition.Add("long_average", typeof(long), "Long Average", "Data of type Long").DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.Add("long_sum", typeof(long), "Long Sum", "Data of type Long").DefaultTrend = EventMetricValueTrend.Sum;
valueDefinition.Add("ulong_average", typeof(ulong), "ULong Average", "Data of type ULong").DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.Add("ulong_sum", typeof(ulong), "ULong Sum", "Data of type ULong").DefaultTrend = EventMetricValueTrend.Sum;
valueDefinition.Add("decimal_average", typeof(decimal), "Decimal Average", "Data of type Decimal").DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.Add("decimal_sum", typeof(decimal), "Decimal Sum", "Data of type Decimal").DefaultTrend = EventMetricValueTrend.Sum;
valueDefinition.Add("double_average", typeof(double), "Double Average", "Data of type Double").DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.Add("double_sum", typeof(double), "Double Sum", "Data of type Double").DefaultTrend = EventMetricValueTrend.Sum;
valueDefinition.Add("float_average", typeof(float), "Float Average", "Data of type Float").DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.Add("float_sum", typeof(float), "Float Sum", "Data of type Float").DefaultTrend = EventMetricValueTrend.Sum;
valueDefinition.Add("timespan_average", typeof(TimeSpan), "TimeSpan Average", "Data of type TimeSpan").DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.Add("timespan_sum", typeof(TimeSpan), "TimeSpan Sum", "Data of type TimeSpan").DefaultTrend = EventMetricValueTrend.Sum;
valueDefinition.Add("timespan_runningaverage", typeof(TimeSpan), "TimeSpan Running Average", "Data of type TimeSpan represented as a running average.").DefaultTrend = EventMetricValueTrend.RunningAverage;
valueDefinition.Add("timespan_runningsum", typeof(TimeSpan), "TimeSpan Running Sum", "Data of type TimeSpan represented as a running sum.").DefaultTrend = EventMetricValueTrend.RunningSum;
valueDefinition.Add("string", typeof(string), "String", "Data of type String");
valueDefinition.Add("system.enum", typeof(UserDataEnumeration), "System.Enum", "Data of type System.Enum");
newEventMetric.DefaultValue = newEventMetric.Values["int_average"];
newEventMetric = newEventMetric.Register(); // Register it with the collection.
//Create this instance of that definition
newEventMetric.Metrics.Add("This Experiment");
}
/// <summary>Return a registered event metric instance for the provided event metric definition.</summary>
/// <remarks><para>If the provided event metric definition is an unregistered raw definition, it will be registered
/// as a completed definition (or a matching registered event metric definition will be used in place of it), but
/// an inability to successfully register the definition will result in an ArgumentException, as with calling
/// the Register() method in EventMetricDefinition. Using a properly-registered definition is preferred.</para>
/// <para>If an event metric with that instance name already exists for that registered definition, it will be
/// returned. Otherwise, one will be created from that definition and returned.</para></remarks>
/// <param name="definition">The metric definition for the desired metric instance.</param>
/// <param name="instanceName">The desired instance name (may be null for the default instance).</param>
/// <returns>The EventMetric object for the requested event metric instance.</returns>
/// <example>
/// See the <see cref="EventMetric">EventMetric Class Overview</see> for an example.
/// </example>
public static EventMetric Register(EventMetricDefinition definition, string instanceName)
{
if (definition == null)
{
// Uh-oh. They gave us a non-EventMetricDefinition?
return(null);
}
EventMetricDefinition metricDefinition;
lock (definition.Lock)
{
if (definition.IsReadOnly == false)
{
// Uh-oh. They gave us a raw event metric definition which wasn't registered.
// But they're calling Register(), so they'd expect us to complete registration for them in this call.
metricDefinition = definition.Register();
}
else
{
// Assume this is a registered definition. ToDo: Make sure they only get IsReadOnly when actually registered.
metricDefinition = definition;
}
}
EventMetric eventMetric;
EventMetricCollection metrics = metricDefinition.Metrics;
lock (metrics.Lock)
{
if (metrics.TryGetValue(instanceName, out eventMetric) == false)
{
eventMetric = metrics.Add(instanceName);
}
}
return(eventMetric);
}
private static EventMetricDefinition GetMetricDefinition()
{
if (!EventMetricDefinition.TryGetValue(MetricSystem, MetricCategory, MetricCaption, out var eventMetricDefinition))
{
eventMetricDefinition = new EventMetricDefinition(MetricSystem, MetricCategory, MetricName)
{
Caption = MetricCaption,
Description = MetricDescription
};
eventMetricDefinition.AddHitCount(MetricValue.PageName, "Page", "The page name without path");
eventMetricDefinition.AddHitCount(MetricValue.AbsolutePath, "Absolute Path",
"The full path from the root of the web site to the page that was requested including the page");
eventMetricDefinition.AddDuration(MetricValue.TotalDuration,
"Total Request Duration",
"The entire time it took for the request to be satisfied");
eventMetricDefinition.AddDuration(MetricValue.AuthenticateDuration,
"Authenticate Request Duration",
"The time it took for the request to be authenticated");
eventMetricDefinition.AddDuration(MetricValue.AuthorizeRequestDuration,
"Authorize Request Duration",
"The time it took for the request to be authorized");
eventMetricDefinition.AddDuration(MetricValue.ResolveRequestCacheDuration,
"Resolve Request Cache Duration",
"The time it took for the request to be looked up in cache");
eventMetricDefinition.AddDuration(MetricValue.AcquireRequestStateDuration,
"Acquire Request State Duration",
"The time it took for the request state to be acquired");
eventMetricDefinition.AddDuration(MetricValue.RequestHandlerExecuteDuration,
"Request Handler Execute Duration",
"The time it took for the request handler to execute. This includes the time for most ASP.NET page code");
eventMetricDefinition.AddDuration(MetricValue.ReleaseRequestStateDuration,
"Release Request State Duration",
"The time it took for the request state to be released");
eventMetricDefinition.AddDuration(MetricValue.UpdateRequestCacheDuration,
"Update Request Cache Duration",
"The time it took for the request cache to be updated");
eventMetricDefinition.AddDuration(MetricValue.LogRequestDuration,
"Log Request Duration",
"The time it took for the request to be logged");
eventMetricDefinition.AddFlag(MetricValue.ServedFromCache,
"Cached Response",
"Indicates if the response was served from the output cache instead of generated");
eventMetricDefinition.AddHitCount(MetricValue.QueryString,
"Query String",
"The query string used for the request");
eventMetricDefinition.AddCount(MetricValue.UserName,
"User",
"The user associated with the action being performed");
eventMetricDefinition.AddCount(MetricValue.SessionId,
"SessionId",
"Session Id associated with action being performed");
eventMetricDefinition.AddCount(MetricValue.AgentSessionId,
"AgentSessionId",
"Id from JavaScript agent for session");
EventMetricDefinition.Register(ref eventMetricDefinition);
}
return(eventMetricDefinition);
}
/// <summary>
/// Create a GC Event Listener (which will automatically start listening to and recording events)
/// </summary>
public GCEventListener()
{
//define our event metric now.
var newEventMetricDefinition = new EventMetricDefinition(Log.Metrics, ProcessMonitor.ProcessMetricType, "Process.Memory", "Garbage Collection");
EventMetricValueDefinition valueDefinition;
var valueDefinitions = (EventMetricValueDefinitionCollection)newEventMetricDefinition.Values;
valueDefinition = valueDefinitions.Add(GenerationSize0Field, typeof(ulong), "Gen 0 Heap Size", "The size, in bytes, of generation 0 memory");
valueDefinition.DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.UnitCaption = "Bytes";
valueDefinition = valueDefinitions.Add(TotalPromotedSize0Field, typeof(ulong), "Total Promoted Size 0", "The size, in bytes, of generation 0 memory");
valueDefinition.DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.UnitCaption = "Bytes";
valueDefinition = valueDefinitions.Add(GenerationSize1Field, typeof(ulong), "Gen 1 Heap Size", "The size, in bytes, of generation 1 memory");
valueDefinition.DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.UnitCaption = "Bytes";
valueDefinition = valueDefinitions.Add(TotalPromotedSize1Field, typeof(ulong), "Total Promoted Size 1", "The number of bytes that are promoted from generation 1 to generation 2.");
valueDefinition.DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.UnitCaption = "Bytes";
valueDefinition = valueDefinitions.Add(GenerationSize2Field, typeof(ulong), "Gen 2 Heap Size", "The size, in bytes, of generation 2 memory.");
valueDefinition.DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.UnitCaption = "Bytes";
valueDefinition = valueDefinitions.Add(TotalPromotedSize2Field, typeof(ulong), "Total Promoted Size 2", "The number of bytes that survived in generation 2 after the last collection.");
valueDefinition.DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.UnitCaption = "Bytes";
valueDefinition = valueDefinitions.Add(GenerationSize3Field, typeof(ulong), "Gen 3 Heap Size", "The size, in bytes, of the large object heap.");
valueDefinition.DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.UnitCaption = "Bytes";
valueDefinition = valueDefinitions.Add(TotalPromotedSize3Field, typeof(ulong), "Total Promoted Size 3", "The number of bytes that survived in the large object heap after the last collection.");
valueDefinition.DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.UnitCaption = "Bytes";
valueDefinition = valueDefinitions.Add(FinalizationPromotedSizeField, typeof(ulong), "Finalization Promoted Size", "The total size, in bytes, of the objects that are ready for finalization.");
valueDefinition.DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.UnitCaption = "Bytes";
valueDefinition = valueDefinitions.Add(FinalizationPromotedCountField, typeof(ulong), "Finalization Promoted Count", "The number of objects that are ready for finalization.");
valueDefinition.DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.UnitCaption = "Objects";
valueDefinition = valueDefinitions.Add(PinnedObjectCountField, typeof(uint), "Pinned Object Count", "The number of pinned (unmovable) objects.");
valueDefinition.DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.UnitCaption = "Objects";
valueDefinition = valueDefinitions.Add(SinkBlockCountField, typeof(uint), "Sink Block Count", "The number of synchronization blocks in use.");
valueDefinition.DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.UnitCaption = "Locks";
valueDefinition = valueDefinitions.Add(GCHandleCountField, typeof(uint), "GC Handle Count", "The number of garbage collection handles in use.");
valueDefinition.DefaultTrend = EventMetricValueTrend.Average;
valueDefinition.UnitCaption = "Handles";
valueDefinition = valueDefinitions.Add(ClrInstanceIDField, typeof(ushort), "CLR Instance Id", "Unique ID for the instance of CLR or CoreCLR.");
newEventMetricDefinition.DefaultValue = newEventMetricDefinition.Values[GenerationSize0Field];
newEventMetricDefinition = newEventMetricDefinition.Register(); //register it with the collection.
//create the default instance for us to log to.
_eventMetric = EventMetric.AddOrGet(newEventMetricDefinition, null);
}
