Integrate OneAgent on Azure App Service for Linux and containers
Linux only
App Service on Linux supports two scenarios.
-
Bring your own code
In the code scenario, App Service provides a base container that is maintained by the platform.
This container targets:
A development framework, such as .NET Core, PHP, or Node.js.
A version of that framework, such as .NET Core 3.0 or .NET Core 3.1.
Follow the procedure on the Built-in image tab.
-
Bring your own container
In the container scenario, App Service provides a host where a custom container provided by the customer can execute.
For details on the differences between the two scenarios, see Things you should know: Web Apps on Linux.
To monitor App Services on Linux, you need to integrate OneAgent within your containerized application.
Follow the procedure on the Custom image tab.
Additional configuration optional
Use additional environment variables to configure OneAgent for troubleshooting or advanced networking. You can either set them via your App Service Application settings or, when using a custom container image, configure them within your application image Dockerfile.
Networking variables
Parameter | Description |
---|---|
| Specifies to use a network zone. For more information, see network zones. |
| When using a proxy, use this environment variable to pass proxy credentials. For more information, see Set up OneAgent on containers for application-only monitoring. |
Additional metadata for process grouping and service detection
When listing multiple tags, you need to put them in double quotes, for example: DT_TAGS="Tag1=Value1 Tag2=Value2".
Parameter | Description |
---|---|
| Multiple containers are sometimes detected as a single instance (localhost), leading to various problems in, for example, service detection or availability alerts. Use this environment variable to define a unique name for your container instance. For details, see Service detection and naming |
| Some technologies don't provide unique application names. In such cases, use this environment variable to provide a unique name. For more information, see Web server naming issues. |
| Applies custom tags to your process group. |
| Applies custom metadata to your process group. |
| If the process group detection rules won't work for your use case, use this environment variable to group all processes with the same value. |
| If the process group detection rules won't work for your use case, use this environment variable to separate process group instances. |
Validating variables
Parameter | Description |
---|---|
| Set this variable with |
| Use this environment variable to define the console log level. Valid options are: |
| Set to |
Update OneAgent
Uninstall OneAgent
Potential conflict with Application Insights
OneAgent may conflict with Azure Application Insights agents already instrumenting the application. If you don't see any monitoring data coming in, check if you have turned on Application Insights and re-try with Application Insights turned off.