Conventions used

There are a number of text conventions used throughout this book.

Code in text: Indicates code words in text, database table names, folder names, filenames, file extensions, pathnames, dummy URLs, user input, and Twitter handles. Here is an example: “Another option is to pass the traceparent value in W3C Trace Context format to the StartActivity method as a string.”

A block of code is set as follows:

using var activity = Source.StartActivity("DoWork");
try
{
  await DoWorkImpl(workItemId);
}
catch
{
  activity?.SetStatus(ActivityStatusCode.Error);
}

When we wish to draw your attention to a particular part of a code block, the relevant lines or items are set in bold:

using var provider = Sdk.CreateTracerProviderBuilder()
  .ConfigureResource(b => b.AddService("sample"))
  .AddSource("Worker")
  .AddJaegerExporter()

Any command-line input or output is written as follows:

$ docker-compose up --build
$ dotnet run

Bold: Indicates a new term, an important word, or words that you see onscreen. For instance, words in menus or dialog boxes appear in bold. Here is an example: “Let’s open the trace file with PerfView and then click on the Thread Time option.”

Tips or important notes

Appear like this.