1. Getting started guide

Before starting

We preperad 2 min video about how to install and use Diol. Please don't forget to like the video and subscribe to the channel (^_^)

Prerequisites

Visual studio extension

1. Open your VS
2. Go to Extensions -> Manage Extensions
3. Search Diol
4. Install

How to open the extension

1. Go to Views -> Other Windows -> Diol ("IO" icon)
2. The tool window should be opened
3. You can attach it to some place.
4. Don't forget to click Sync button

Cool, now we are ready to start!

How to use

1. Create new asp.net core application or use our example link. In the example we will show our sample.
2. Add several things (if you created your own app):

• in Program.cs -> builder.Services.AddHttpClient();
• in Program.cs -> app.UseHttpLogging();
• in appsettings.Development.json

{
  "DetailedErrors": true,
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning",
      "Microsoft.AspNetCore.HttpLogging.HttpLoggingMiddleware": "Trace",
      "System.Net.Http.HttpClient": "Trace"
    },
    "EventSource": {
      "LogLevel": {
        "Default": "None",
        "Microsoft.AspNetCore.HttpLogging.HttpLoggingMiddleware": "Trace",
        "System.Net.Http.HttpClient": "Trace"
      }
    }
  }
}

3. Run with debug your application

Note

There is a known issue where Visual Studio debugger may cause invalid Activity IDs to be generated. Either don't run this sample under the debugger or set a breakpoint at the beginning of Main and evaluate the expression 'System.Threading.Tasks.TplEventSource.Log.TasksSetActivityIds = false' in the immediate window before continuing to work around the issue.

Documentation

4. Open Diol
5. Click Start in Diol Tool windows
6. Add breakpoint to /api/process-id endpoint.
7. Navigate to swagger page (http://localhost:[<your_port>]/swagger
8. Call GET /api/process-id
9. You should see a new row in 'Aspnet core' tab (Diol tool window)
10. Press Continue debugging and return to Diol
11. You also can click on row and see detail information!

Congrats!

More information

How to setup logs

Http

1. Add builder.Services.AddHttpClient(); in program.cs
2. Update appsettings.development.json

"EventSource": {
      "LogLevel": {
        "Default": "None",
        "System.Net.Http.HttpClient": "Trace"
      }
    }

Aspnet

1. Add in program.cs

builder.Services.AddHttpLogging(options =>
{
    options.LoggingFields = HttpLoggingFields.All;
});

2. Add app.UseHttpLogging(); in program.cs
3. Update appsettings.development.json

"EventSource": {
      "LogLevel": {
        "Default": "None",
        "Microsoft.AspNetCore.HttpLogging.HttpLoggingMiddleware": "Trace"
      }
    }

EntityFramework

1. Add EF to your project
2. Update 'appsettings.development.json'

"EventSource": {
      "LogLevel": {
        "Default": "None",
        "Microsoft.EntityFrameworkCore": "Trace"
      }
    }

In progress

1. We are working on a solution for Diol Backend Service installation process. Until this you should run it once
2. We are working on a solution to not click sync and start manually.