Github Repo: langtrace-azure-setup

​
Requirements

  1. Azure account
  2. Clickhouse DB self hosted or managed service
  3. Azure developer cli on your system. (installation steps)

​
Resources Created

Resource TypeNameComments
Resource Group[project-name]-rgA resource group where all the resources will be deployed.
Postgres Server[project-name]-pgAzure Postgres flexible server with backup on.
Postgres Firewall[project-name]-pg-fwFirewall that is open to world.
App Service Plan[project-name]-spApp service plan to run Langtrace app.
App Service[project-name]-appApp service to run Langtrace app.

​
Setup

The following steps are for development purpose only and serves as a reference for production usecases. If you wish to setup production, make sure to scale the resources accordingly.

​
Step 1: Clone and update configuration

​
Clone the repository using the following command:

git clone https://github.com/Scale3-Labs/langtrace-azure-setup.git
cd langtrace-azure-setup
Update the region and username and passwords of the admin user and Postgres DB based on your preference in the file main.tfvars.json. You can also modify variables.tf based on your setup requirements.

​
Step 2: Configure Authentication

Before deploying, you need to configure authentication for your Langtrace instance:
  1. Open the main.tfvars.json file.
  2. Locate the authentication-related variables (e.g., admin_email, admin_password).
  3. Update these variables with your desired authentication settings.
  4. For additional authentication methods (e.g., Google OAuth, Azure AD), add the necessary variables to this file.
For detailed instructions on authentication options, refer to our Authentication guide.

​
Step 3. Run the Deploy

Run the following command to initiate the deploy process 
azd up
Now you will be asked to input the following variables. Give a unique name for langtrace_project as it would be part of the self-hosted langtrace app URL. azure

​
Step 4. Access the Langtrace app

Once you have provided the inputs, the deployment process will take about 15 minutes to provision all the resources. Once the deployment is successful, you will see the output with a URL as below. 
Outputs:

langtrace_url = "https://langtraceblog-app.azurewebsites.net"
Open the URL and login using admin credentials. Admin credentials are in the file main.tfvars.json under the key admin_email and admin_password. You can now start using Langtrace in your application! 🎉

​
Cleanup

To cleanup the resources, run the following command 
azd down
While running this command, you will be asked for variables, you can enter anything or keep it blank.
Within five minutes, all the resources will be deleted from your Azure account.

​
Troubleshooting

​
Next Steps

After successfully deploying Langtrace on Azure, ensure that you’ve properly configured your chosen authentication method(s) and created the necessary user accounts. If you need to modify the authentication settings post-deployment, you may need to update the App Service configuration in the Azure portal. Refer to the Authentication guide for detailed instructions on managing authentication.