装饰双螺旋

如何在 AEM 云服务上跟踪 AEM、Dispatcher 和 CDN 日志

为了监控或调试 AEM 环境(或几乎任何 Web 环境),需要数据,而这些数据通常来自服务器日志。聚合 AEM 云服务中某个实例的所有日志的唯一方法是使用 Splunk ,但如果您尚未设置该功能,则有一种方法

此时, 可以通过以下两种方式之一访问您的 AEM 日志

如果一个人在 AEM 实例(特别是通常用作 AEM 开发团队的共享开发环境的 RDE 环境)上进行主动开发,即使他无法进行关键的时间关联、图形绘制、历史查询以及使用日志聚合器执行的所有其他操作。

此外,由于日志记录需要通过 Adobe 的板载 Splunk 实例进行,因此在 AEM 端生成日志和在命令行上出现日志之间偶尔会出现延迟。

因此,以下是在 AEM 作为云服务环境中查看尾部日志的步骤:

步骤 1:Cloud Manager 的 Adobe IO 访问

您要检查的第一步是确保您的 Adobe 帐户具有使用 Cloud Manager 在 Adobe IO 上创建服务集成的权限。如果您使用 Adobe ID 前往https://console.adobe.io并创建新项目,请选择“添加 API”。您应该在可用集成列表中的 Experience Cloud 下看到“Cloud Manager”。

如果您拥有 Cloud Manager 访问权限,Adobe IO 控制台应该是什么样子

为了进入 Adobe IO 控制台,您需要拥有由 Adobe Admin Console 管理员设置的 Cloud Manager 上的“开发人员”权限。

步骤 2:为您的云管理器(和日志)访问创建 Adobe IO 项目

选择 OAuth 服务器到服务器身份验证作为您需要的身份验证类型。以前,AIO 插件使用 JWT 凭证,但 Adobe 正在逐步淘汰这些凭证,转而使用更易于实现和维护的 OAuth。

然后,告诉集成它将访问哪些服务:

然后点击“保存已配置的 API”。

步骤 3:安装 Adobe IO Runtime

本页提供了安装 Adobe IO 运行时的完整安装说明。简而言之,在工作站上安装 NodeJS 后,您可以:

$ npm install -g @adobe/aio-cli

安装后,您应该看到:

$ aio -v
@adobe/aio-cli/10.0.0 linux-x64 node-v20.10.0

步骤 4:安装并配置 Adobe IO Cloud Manager CLI 插件

完整的安装说明在这里,简而言之,运行:

$ aio plugins:install @adobe/aio-cli-plugin-cloudmanager

步骤 5:选择您的组织和环境

使用以下方式验证您的环境:

$ aio cloudmanager:org:select

获取您正在使用的程序的 programID:

$ aio cloudmanager:list-programs
 Program Id Name                                  Enabled 
 ────────── ───────────────────────────────────── ─────── 
 100007     TestCorp AEM Site				 true 

将该程序设置为 AIO 的默认程序:

aio config:set cloudmanager_programid 100007

使用以下方式验证您的环境:

$ aio cloudmanager:list-environments
 Environment Id Name                                      Type Description 
 ────────────── ───────────────────────────────────────── ──── ─────────── 
 1000001        my-rde-env                                rde              
 1000003        my-dev-env                                dev  

步骤 6:列出环境的日志

请记下每个环境所具有的环境 ID 数字。如果您使用此 ID,您可以列出该环境可用的日志。

请注意,除了您习惯的 AEM 访问、请求和错误日志以及调度程序日志之外,还可以在此处跟踪 CDN 日志,这对于调试缓存命中率等非常有用。

$ aio cloudmanager:list-available-log-options 1000003
 Environment Id Service    Name          
 ────────────── ────────── ───────────── 
 1000003        author     aemaccess     
 1000003        author     aemerror      
 1000003        author     aemrequest    
 1000003        author     cdn           
 1000003        publish    aemaccess     
 1000003        publish    aemerror      
 1000003        publish    aemrequest    
 1000003        publish    cdn           
 1000003        dispatcher httpdaccess   
 1000003        dispatcher httpderror    
 1000003        dispatcher aemdispatcher

步骤 7:跟踪所需日志

aio cloudmanager:tail-log 1000003 author aemacces
[cm-p1234-e10001-aem-author-674d744bf5-q862v] *INFO* [67.189.6.206 [1591669210392] POST /content/dam.initiateUpload.json HTTP/1.1] com.adobe.cq.assetcompute.impl.servlet.InitiateUploadAssetServlet initiate upload asset: Mountain Biking the Uetliberg in Zurich.mp4, size: 74013446, mimeType: video/mp4 09.06.2020 02:20:10.397 [cm-p1234-e10001-aem-author-674d744bf5-q862v] *INFO* [67.189.6.206 [1591669210392] POST /content/dam.initiateUpload.json HTTP/1.1] com.adobe.cq.assetcompute.impl.servlet.InitiateUploadAssetServlet initiate upload complete asset : Mountain Biking the Uetliberg in Zurich.mp4, size: 74013446, mimeType: video/mp4

它很麻烦,步骤很多,而且它不是 Splunk。但它比没有要好得多,而且如果您要在实例上进行任何类型的开发工作,它绝对是必要的。

希望这对你有帮助!

关于作者

泰德·里夫斯

Arbory Digital 首席架构师

AEM 架构师和 DevOps 人员,拥有 14 年 AEM/CQ 经验和 25 年以上系统基础设施经验。

在 Linkedin 上联系 Tad

喜欢你听到的吗?对于什么适合您有疑问吗?我们很乐意与您沟通!联系我们

播客节目

category
AEM Technical Help, AEM News, Arbory Digital News, Customer Stories, Podcasts
tags
aemaacs
number of rows
1