Azure部署的Ghost 1.21.3添加Application Insights的位置咨询

我刚好处理过类似的Ghost 1.x版本集成Application Insights的需求，给你分享下可行的步骤，亲测在1.21.3版本有效：

步骤1：安装Application Insights依赖 #

首先在你的Ghost根目录（部署到Azure的那套代码文件夹）执行以下命令，安装官方的Node.js SDK：

npm install applicationinsights --save

如果是通过Azure部署（比如Git或Zip部署），要确保部署过程会自动执行npm install，可以在Azure应用服务的部署中心配置里确认这一点。

步骤2：找到Ghost的启动入口文件 #

Ghost 1.21.3的启动入口是根目录下的index.js，这个文件是Ghost启动的第一个文件，在这里初始化App Insights能确保捕获到所有后续的请求、性能数据和异常。

步骤3：添加App Insights初始化代码 #

打开根目录的index.js，在文件的最顶部添加以下代码：

// 初始化Application Insights
const appInsights = require('applicationinsights');
// 推荐用环境变量存储Instrumentation Key，避免硬编码
if (process.env.APPINSIGHTS_INSTRUMENTATIONKEY) {
    appInsights.setup(process.env.APPINSIGHTS_INSTRUMENTATIONKEY)
        .setAutoCollectRequests(true) // 自动收集HTTP请求
        .setAutoCollectPerformance(true) // 自动收集性能数据
        .setAutoCollectExceptions(true) // 自动捕获未处理异常
        .start();
}

关键注意点： #

• 一定要把这段代码放在文件最顶部，在任何Ghost相关的require之前，否则App Insights无法捕获到Ghost启动阶段的请求和错误。
• 不要硬编码你的Instrumentation Key，建议在Azure应用服务的「配置」→「应用程序设置」里添加环境变量APPINSIGHTS_INSTRUMENTATIONKEY，值填你的Application Insights密钥，这样更安全也方便后续修改。

步骤4：部署并验证 #

把修改后的代码部署到Azure，然后重启你的Ghost应用服务。等待几分钟后，打开对应的Application Insights资源，查看「日志」或「性能」面板，应该能看到Ghost的请求数据、性能指标和异常信息了。

常见问题排查 #

• 如果出现Cannot find module 'applicationinsights'错误：检查部署过程是否执行了npm install，或者手动在Azure的Kudu控制台（https://<你的应用名>.scm.azurewebsites.net/）进入Ghost目录执行npm install。
• 如果没有数据进入App Insights：确认环境变量APPINSIGHTS_INSTRUMENTATIONKEY配置正确，并且App Insights资源和Ghost应用在同一个Azure区域（避免网络延迟），同时检查Ghost的日志是否有App Insights相关的报错。

后续升级注意事项 #

因为修改了Ghost的核心启动文件，后续升级Ghost版本时，这个修改会被覆盖，记得升级后重新添加这段初始化代码，或者考虑把这段逻辑封装成一个简单的Ghost自定义插件（不过1.21.3的插件系统相对有限，直接修改启动文件是最快捷的方式）。

内容的提问来源于stack exchange，提问作者Akos Nagy