@ -36,7 +36,7 @@ Before opening our .sln files in Visual Studio or VS Code, we recommend performi
This will download the required tools and build the entire repository once. At that point, you should be able to open .sln files to work on the projects you care about.
> :bulb: Pro tip: you will also want to run this command after pulling large sets of changes. On the master branch, we regularly update the versions of .NET Core SDK required to build the repo.
> :bulb: Pro tip: you will also want to run this command after pulling large sets of changes. On the main branch, we regularly update the versions of .NET Core SDK required to build the repo.
> You will need to restart your editor every time we update the .NET Core SDK.
2. Use the `startvs.cmd` script to open Visual Studio .sln files. This script first sets the required environment variables.
Starting from the [sample here](https://github.com/dotnet/tye/tree/master/samples/frontend-backend), we are going to transform the backend from a web application to an azure function app.
Starting from the [sample here](https://github.com/dotnet/tye/tree/main/samples/frontend-backend), we are going to transform the backend from a web application to an azure function app.
To start, create an Azure Function project in a folder called `backend-function`. You can do this via:
- [Visual Studio Code](https://docs.microsoft.com/en-us/azure/azure-functions/functions-create-first-function-vs-code?pivots=programming-language-csharp)
@ -14,7 +14,7 @@ Tye can get distributed tracing working easily without adding any SDKs or librar
The first step is to enable the W3C trace format in your .NET applications. **This is mandatory, you won't get traces without doing this!**
> :bulb: If you want an existing sample to run, the [sample here](https://github.com/dotnet/tye/tree/master/samples/frontend-backend) will do. This sample code already initializes the trace format.
> :bulb: If you want an existing sample to run, the [sample here](https://github.com/dotnet/tye/tree/main/samples/frontend-backend) will do. This sample code already initializes the trace format.
You need to place the following statement somewhere early in your program:
@ -97,7 +97,7 @@ To use zipkin for distributed tracing in a deployed application, we first need t
Run the following to deploy a minimal zipkin configuration:
> :warning: This is the most basic possible deployment of zipkin. There's no data persistence here!
@ -125,7 +125,7 @@ Tye will prompt for the zipkin URI. If you've followed these basic instructions,
Now to test it out!
Use kubectl to port forward to one of your services. This is what it looks like using the [sample here](https://github.com/dotnet/tye/tree/master/samples/frontend-backend).
Use kubectl to port forward to one of your services. This is what it looks like using the [sample here](https://github.com/dotnet/tye/tree/main/samples/frontend-backend).
```sh
> kubectl port-forward svc/frontend 5000:80
@ -152,7 +152,7 @@ To remove the deployed application run the following commands:
@ -6,7 +6,7 @@ Tye can push logs to Elastic stack easily without the need for any SDKs or code
## Getting started: running locally with Elastic stack
> :bulb: If you want an existing sample to run, the [sample here](https://github.com/dotnet/tye/tree/master/samples/frontend-backend) will do. This recipe will show examples of UI and data based on that sample. You own application will work fine, but the data and examples will look different.
> :bulb: If you want an existing sample to run, the [sample here](https://github.com/dotnet/tye/tree/main/samples/frontend-backend) will do. This recipe will show examples of UI and data based on that sample. You own application will work fine, but the data and examples will look different.
The first step is to add the `elastic` extension to your `tye.yaml`. Add the `extensions` node and its children from the example below.
@ -76,7 +76,7 @@ The basic idea is that because log aggregation pulls all of the logs together ac
We'll use the discover tab to build a basic query.
First, perform some operation that will trigger a cross-service call so we have some data to use. If you're using the [sample here](https://github.com/dotnet/tye/tree/master/samples/frontend-backend) then visiting the frontend application in the browser will do.
First, perform some operation that will trigger a cross-service call so we have some data to use. If you're using the [sample here](https://github.com/dotnet/tye/tree/main/samples/frontend-backend) then visiting the frontend application in the browser will do.
Next, let's add some fields to the query. The left pane in Kibana has all of the known fields. Select the following by clicking on the `Add` button near each of them:
@ -96,4 +96,4 @@ Hover over on of the values of `fields.TraceId` for a request to `backend` and c
Now you can see all of the log messages for just that operation, across both the `frontend` and `backend` services. This kind of query can be useful when you want to investigate a problem that occured in the past, and see exactly what was logged by each service that participated in the operation.
Now you can see all of the log messages for just that operation, across both the `frontend` and `backend` services. This kind of query can be useful when you want to investigate a problem that occured in the past, and see exactly what was logged by each service that participated in the operation.
@ -6,7 +6,7 @@ Tye can push logs to Seq easily without the need for any SDKs or code changes in
## Getting started: running locally with Seq
> :bulb: If you want an existing sample to run, the [sample here](https://github.com/dotnet/tye/tree/master/samples/frontend-backend) will do. This recipe will show examples of UI and data based on that sample. You own application will work fine, but the data and examples will look different.
> :bulb: If you want an existing sample to run, the [sample here](https://github.com/dotnet/tye/tree/main/samples/frontend-backend) will do. This recipe will show examples of UI and data based on that sample. You own application will work fine, but the data and examples will look different.
The first step is to add the `seq` extension to your `tye.yaml`. Add the `extensions` node and its children from the example below.