在 Azure App Services (Linux) 中安装 .NET 代理

通过集成 Site24x7 APM Insight .NET 代理，监控托管在 Linux 上的 Azure App Service 中的 .NET 应用程序。

您可以使用以下任一方法安装代理：

使用自定义部署脚本
使用 NuGet 包和应用程序设置

使用自定义部署脚本

使用自定义启动脚本安装 .NET 代理，该脚本在应用程序启动时自动完成安装和配置。

步骤 1：创建部署脚本

导航至 /home 目录。
在该路径下创建一个名为 apm-dotnetagent-deploy.sh 的新 Shell 脚本。

将以下内容添加到脚本中：

#!/bin/bash
set -e

LICENSE_KEY="YOUR_LICENSE_KEY"
SITE24X7_APP_NAME="YOUR_APPLICATION_NAME"
AGENT_HOME="/home/apminsight/dotnet"
AGENT_DIR="$AGENT_HOME/ApmInsightDotNetCoreAgent"

echo "Setting environment variables..."

export SITE24X7_APP_NAME="$SITE24X7_APP_NAME"
export S247_LICENSE_KEY="$LICENSE_KEY"
export CORECLR_ENABLE_PROFILING=1
export CORECLR_PROFILER="{9D363A5F-ED5F-4AAC-B456-75AFFA6AA0C8}"
export CORECLR_SITE24X7_HOME="$AGENT_DIR"
export CORECLR_PROFILER_PATH_64="$AGENT_DIR/x64/libClrProfilerAgent.so"
export CORECLR_PROFILER_PATH_32="$AGENT_DIR/x86/libClrProfilerAgent.so"
export DOTNET_STARTUP_HOOKS="$AGENT_DIR/netstandard2.0/DotNetAgent.Loader.dll"
export MANAGEENGINE_COMMUNICATION_MODE="ExporterService"

if [ -d "$AGENT_DIR" ]; then
    echo "APM Insight agent directory already exists. Skipping installation..."
else
    echo "Agent directory not found. Proceeding with installation..."

    echo "Updating packages and installing unzip..."
    apt-get update
    apt-get install -y unzip vim-common

    wget https://staticdownloads.site24x7.com/apminsight/agents/dotnet/apminsight-dotnetcoreagent-linux.sh
    chmod +x apminsight-dotnetcoreagent-linux.sh

    # Patch xxd usage
    sed -i 's/xxd -p/od -An -tx1 | tr -d " \\n"/g' apminsight-dotnetcoreagent-linux.sh

    echo "Installing .NET Core Agent..."
    printf "A\n" | ./apminsight-dotnetcoreagent-linux.sh \
        -Destination "$AGENT_HOME" \
        -LicenseKey "$LICENSE_KEY"

    rm -f apminsight-dotnetcoreagent-linux.sh

    wget -O InstallDataExporter.sh \
    https://staticdownloads.site24x7.com/apminsight/S247DataExporter/linux/InstallDataExporter.sh

    chmod +x InstallDataExporter.sh
    sh InstallDataExporter.sh
    rm -f InstallDataExporter.sh
fi

# YOUR APPLICATION STARTUP COMMAND GOES HERE

注意

将 YOUR_LICENSE_KEY 替换为您的 Site24x7 许可证密钥。
将 YOUR_APPLICATION_NAME 替换为您在 Site24x7 中的应用程序名称。

步骤 2：修改启动命令

打开 Azure 门户。
导航至您的 Web 应用。
转至设置 > 配置。
在常规设置选项卡下，找到启动命令字段。

输入以下命令：

yes | bash /home/apm-dotnetagent-deploy.sh

单击保存。

步骤 3：重启 Web 应用

更新启动命令后：

在 Azure 门户中，导航至您的 Web 应用。
单击重启。

下一步

转至您的 Site24x7 APM Insight 仪表板，检查应用程序是否已显示。

使用 NuGet 包和应用程序设置

通过添加 NuGet 包并在 Azure App Service 中配置所需的环境变量来安装 .NET 代理。

使用您偏好的方式（例如 Visual Studio NuGet 管理器或 CLI）将 NuGet 包 Site24x7.APMInsight.Agent 添加到您的 .NET 项目。
构建应用程序并将其发布到 Azure App Service (Linux)。
在 Azure 门户中，导航至您的 App Service。
转至设置 > 配置 > 应用程序设置。

单击 + 添加，并添加以下环境变量：

CORECLR_ENABLE_PROFILING=1
CORECLR_PROFILER={9D363A5F-ED5F-4AAC-B456-75AFFA6AA0C8}
CORECLR_PROFILER_PATH_32=/home/site/wwwroot/site24x7/x86/libClrProfilerAgent.so
CORECLR_PROFILER_PATH_64=/home/site/wwwroot/site24x7/x64/libClrProfilerAgent.so
DOTNET_STARTUP_HOOKS=/home/site/wwwroot/site24x7/netstandard2.0/DotNetAgent.Loader.dll
DOTNETCOREAGENT_HOME="/home/site/wwwroot/site24x7"
MANAGEENGINE_COMMUNICATION_MODE=direct
S247_LICENSE_KEY=YOUR_LICENSE_KEY_HERE
SITE24X7_APP_NAME=<monitor name>