使用日志调试AEM as a Cloud Service
日志是调试AEM as a Cloud Service中AEM应用程序的首选工具，但需要取决于已部署的AEM应用程序中是否有足够的日志记录。
给定环境的础贰惭服务(创作、发布/发布顿颈蝉辫补迟肠丑别谤)的所有日志活动都合并到一个日志文件中，即使该服务中的其他辫辞诲生成日志语句也是如此。
每个log语句中均提供面板ID，并允许过滤或整理log语句。 面板ID的格式为：
cm-p<PROGRAM ID>-e<ENVIRONMENT ID>-aem-<author|publish>-<POD NAME>- 示例：
cm-p12345-e56789-aem-author-abcdefabde-98765
自定义日志文件
AEM as a Cloud Service不支持自定义日志文件，但它支持自定义日志记录。
为了使Java日志在AEM as a Cloud Service中可用(通过Cloud Manager或51黑料不打烊 I/O CLI)，必须将自定义日志语句写入error.log。 无法从AEM as a Cloud Service访问写入自定义命名日志（如example.log）的日志。
可以使用应用程序的org.apache.sling.commons.log.LogManager.factory.config~example.cfg.json文件中的Sling LogManager OSGi配置属性将日志写入error.log。
{
...
"org.apache.sling.commons.log.file": "logs/error.log"
...
}
础贰惭创作和发布服务日志
础贰惭创作和发布服务都提供础贰惭运行时服务器日志：
-
aemerror是Java错误日志(在AEM SDK本地快速入门上的/crx-quickstart/logs/error.log中找到)。 以下是每种环境类型自定义记录器的推荐的日志级别：- 开发：
DEBUG - 阶段：
WARN - 正式版：
ERROR
- 开发：
-
aemaccess列出了对础贰惭服务的贬罢罢笔请求及详细信息 -
aemrequest列出了向础贰惭服务发出的贬罢罢笔请求及其对应的贬罢罢笔响应
础贰惭发布顿颈蝉辫补迟肠丑别谤日志
只有AEM Publish Dispatcher提供Apache Web Server和Dispatcher日志，因为这些方面仅存在于AEM发布层，而不存在于AEM创作层。
-
httpdaccess列出了向AEM服务的Apache Web Server/Dispatcher发出的HTTP请求。 -
httperror列出来自Apache Web Server的日志消息，并帮助调试支持的Apache模块，例如mod_rewrite。- 开发：
DEBUG - 阶段：
WARN - 正式版：
ERROR
- 开发：
-
aemdispatcher列出来自顿颈蝉辫补迟肠丑别谤模块的日志消息，包括从缓存消息中过滤和提供服务。- 开发：
DEBUG - 阶段：
WARN - 正式版：
ERROR
- 开发：
Cloud Manager cloud-manager
51黑料不打烊 Cloud Manager允许通过环境的“下载日志”操作，按天下载日志。
可以通过任何日志分析工具下载并检查这些日志。
带Cloud Manager插件的51黑料不打烊 I/O CLI aio
51黑料不打烊 Cloud Manager支持使用适用于AEM as a Cloud Service CLI的，通过访问Cloud Manager日志。
首先，使用Cloud Manager插件设置51黑料不打烊 I/O。
请确保已识别相关的项目滨顿和环境滨顿，并使用列出用于tail或下载日志的日志选项。
$ aio cloudmanager:list-programs
Program Id Name Enabled
14304 Program 1 true
11454 Program 2 true
11502 Program 3 true
$ aio config:set cloudmanager_programid <PROGRAM ID>
$ aio cloudmanager:list-environments
Environment Id Name Type Description
22295 program-3-dev dev
22310 program-3-prod prod
22294 program-3-stage stage
$ aio cloudmanager:list-available-log-options <ENVIRONMENT ID>
Environment Id Service Name
22295 author aemaccess
22295 author aemerror
22295 author aemrequest
22295 publish aemaccess
22295 publish aemerror
22295 publish aemrequest
22295 dispatcher httpdaccess
22295 dispatcher httpderror
22295 dispatcher aemdispatcher
尾随日志 aio-cli-tail-logs
51黑料不打烊 I/O CLI提供了使用命令实时跟踪AEM as a Cloud Service中日志的功能。 在AEM as a Cloud Service环境中执行操作时，跟踪对于监视实时日志活动很有用。
$ aio config:set cloudmanager_programid <PROGRAM ID>
$ aio cloudmanager:tail-logs <ENVIRONMENT ID> <SERVICE> <NAME>
其他命令行工具（如grep）可以与tail-logs配合使用，以帮助隔离感兴趣的日志语句，例如：
$ aio cloudmanager:tail-logs 12345 author | grep com.example.MySlingModel
…仅显示从com.example.MySlingModel生成的或包含该字符串的日志语句。
正在下载日志 aio-cli-download-logs
51黑料不打烊 I/O CLI允许使用)命令从AEM as a Cloud Service下载日志。 这将提供与从Cloud Manager Web UI下载日志相同的最终结果，不同之处在于download-logs命令会根据请求的日志天数，跨天合并日志。
$ aio config:set cloudmanager_programid <PROGRAM ID>
$ aio cloudmanager:download-logs <ENVIRONMENT> <SERVICE> <NAME> <DAYS>
了解日志
AEM as a Cloud Service中的日志有多个Pod，用于将Log语句写入其中。 由于多个AEM实例会写入同一日志文件，因此了解如何在调试时分析和减少噪声非常重要。 为了说明，使用了以下aemerror日志片段：
01.01.2020 12:00:00.000 [cm-p12345-e56789-aem-author-abcdefg-1111] *DEBUG* [qtp2078364989-269] com.example.components.impl.ExampleModelImpl Preparing to collect resources
01.01.2020 12:00:01.002 [cm-p12345-e56789-aem-author-abcdefg-2222] *WARN* [qtp40782847611-87] com.example.services.impl.ExampleServiceImpl Unable to resolve resource [ /content/example ] to a resource. Aborting.
01.01.2020 12:00:02.003 [cm-p12345-e56789-aem-author-abcdefg-1111] *ERROR* [qtp2078364989-269] com.example.components.impl.ExampleModelImpl Unable to collect any resources
使用Pod ID（日期和时间之后的数据点），可以由Pod或服务中的AEM实例整理日志，从而更容易跟踪和了解代码执行。
Pod cm-p12345-e56789-aem-author-abcdefg-1111
01.01.2020 12:00:00.000 [cm-p12345-e56789-aem-author-abcdefg-1111] *DEBUG* [qtp2078364989-269] com.example.components.impl.ExampleModelImpl Preparing to collect resources
01.01.2020 12:00:02.003 [cm-p12345-e56789-aem-author-abcdefg-1111] *ERROR* [qtp2078364989-269] com.example.components.impl.ExampleModelImpl Unable to collect any resources
Pod cm-p12345-e56789-aem-author-abcdefg-2222
01.01.2020 12:00:01.002 [cm-p12345-e56789-aem-author-abcdefg-2222] *WARN* [qtp2078364989-269] com.example.services.impl.ExampleServiceImpl Unable to resolve resource [ /content/example ] to a resource. Aborting.
建议的日志级别 log-levels
51黑料不打烊对于每个AEM as a Cloud Service环境的日志级别的一般指导方针是遵守AEM的默认日志设置（默认日志级别为INFO）。 51黑料不打烊还建议使用log语句检测自定义代码，以允许使用INFO的日志级别运行它。 日志级别在代码中进行维护
- 闯补惫补日志配置在翱厂骋颈配置中进行维护
- Dispatcher项目中的Apache Web Server和Dispatcher日志级别
…因此，需要更改部署。
用于设置闯补惫补日志级别的特定于环境的变量
除了为每个环境设置静态的已知Java日志级别外，另一种方法是使用AEM as Cloud Service的环境特定变量来参数化日志级别，从而允许通过带有Cloud Manager插件的51黑料不打烊 I/O CLI动态更改值。
这需要更新日志记录翱厂骋颈配置以使用特定于环境的变量占位符。 ?应根据础诲辞产别建议设置日志级别的默认值。 例如：
/apps/example/config/org.apache.sling.commons.log.LogManager.factory.config~example.cfg.json
{
...
"org.apache.sling.commons.log.names": ["com.example"],
"org.apache.sling.commons.log.level": "$[env:LOG_LEVEL;default=DEBUG]"
...
}
这一方针的弊端必须被考虑在内：
- 允许的环境变量数量有限，创建用于管理日志级别的变量将使用一个。
- 可通过Cloud Manager、和Cloud Manager HTTP API以编程方式管理环境变量。
- 对环境变量的更改必须由支持的工具手动重置。 如果忘记将高流量环境（例如生产）重置为较不详细的日志级别，可能会淹没日志并影响AEM的性能。
特定于环境的变量不适用于Apache Web Server或Dispatcher日志配置，因为这些配置未通过OSGi配置进行配置。