文件AEM as a Cloud Service使用手冊

AEMas a Cloud Service記錄 logging-for-aem-as-a-cloud-service

Last update: Mon Mar 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

AEMas a Cloud Service是一個平台，可供客戶加入自訂程式碼，以為其客戶群建立獨特的體驗。 有鑑於此，記錄服務對於在本機開發和雲端環境(特別是AEMas a Cloud Service的開發環境)上除錯和瞭解程式碼執行至關重要。

AEMas a Cloud Service記錄設定和記錄層級在設定檔案中進行管理，這些設定檔案儲存為Git中AEM專案的一部分，並透過Cloud Manager部署為AEM專案的一部分。 在AEMas a Cloud Service登入可以分成兩個邏輯集：

  • AEM記錄，可在AEM應用程式層級執行記錄
  • Apache HTTPD Web伺服器/Dispatcher記錄，會在發佈層上執行網頁伺服器和Dispatcher的記錄。
  • CDN記錄（如其名稱所示）會在CDN上執行記錄。 此功能將於9月初逐步向客戶推出。

AEM記錄 aem-logging

AEM應用程式層級的記錄由三個記錄檔處理：

  1. AEM Java記錄，可呈現AEM應用程式的Java記錄陳述式。
  2. HTTP請求記錄，會記錄有關AEM所服務的HTTP請求及其回應的資訊
  3. HTTP存取記錄檔，會記錄摘要資訊和AEM所服務的HTTP要求
NOTE
從發佈層的Dispatcher快取或上游CDN提供的HTTP請求不會反映在這些記錄中。

AEM Java記錄 aem-java-logging

AEMas a Cloud Service提供Java記錄陳述式的存取權。 AEM應用程式的開發人員應遵循一般Java記錄最佳實務，在下列記錄層級記錄有關自訂程式碼執行的相關陳述：

AEM環境
記錄層級
說明
記錄陳述式可用性
開發
偵錯
說明應用程式中正在發生的事情。
當DEBUG記錄作用中時，會記錄提供發生之活動以及影響處理的任何關鍵引數之清晰圖表的陳述式。
  • 本機開發
  • 開發
測試
警告
說明有可能變成錯誤的情況。
當WARN記錄作用中時，只會記錄表示接近次最佳化的條件陳述式。
  • 本機開發
  • 開發
  • 測試
生產
錯誤
說明指出失敗及需要解決的條件。
當ERROR記錄作用中時，只會記錄表示失敗的陳述式。 錯誤記錄陳述式指出應儘快解決的嚴重問題。
  • 本機開發
  • 開發
  • 測試
  • 生產

雖然Java記錄支援數個其他層級的記錄粒度，但AEMas a Cloud Service建議您使用上述三個層級。

AEM記錄層級是透過OSGi設定根據環境型別設定，而這些設定又會認可至Git，並透過Cloud Manager部署至AEMas a Cloud Service。 因此，最好讓記錄陳述一致且為環境型別所熟知，以確保透過AEM作為Cloud Service提供的記錄可在最佳記錄層級使用，而不需要以更新的記錄層級設定重新部署應用程式。

紀錄輸出範例

22.06.2020 18:33:30.120 [cm-p12345-e6789-aem-author-86657cbb55-xrnzq] *ERROR* [qtp501076283-1809] io.prometheus.client.dropwizard.DropwizardExports Failed to get value from Gauge
22.06.2020 18:33:30.229 [cm-p12345-e6789-aem-author-86657cbb55-xrnzq] *INFO* [qtp501076283-1805] org.apache.sling.auth.core.impl.SlingAuthenticator getAnonymousResolver: Anonymous access not allowed by configuration - requesting credentials
22.06.2020 18:33:30.370 [cm-p12345-e6789-aem-author-86657cbb55-xrnzq] *INFO* [73.91.59.34 [1592850810364] GET /libs/granite/core/content/login.html HTTP/1.1] org.apache.sling.i18n.impl.JcrResourceBundle Finished loading 0 entries for 'en_US' (basename: <none>) in 4ms
22.06.2020 18:33:30.372 [cm-p12345-e6789-aem-author-86657cbb55-xrnzq] *INFO* [FelixLogListener] org.apache.sling.i18n Service [5126, [java.util.ResourceBundle]] ServiceEvent REGISTERED
22.06.2020 18:33:30.372 [cm-p12345-e6789-aem-author-86657cbb55-xrnzq] *WARN* [73.91.59.34 [1592850810364] GET /libs/granite/core/content/login.html HTTP/1.1] libs.granite.core.components.login.login$jsp j_reason param value 'unknown' cannot be mapped to a valid reason message: ignoring

記錄格式

日期和時間
29.04.2020 21:50:13.398
AEMas a Cloud Service節點ID
[cm-p1234-e5678-aem-author-59555cb5b8-q7l9s]
記錄層級
偵錯
執行緒
qtp2130572036-1472
Java類別
com.example.approval.workflow.impl.CustomApprovalWorkflow
記錄訊息
未指定核准者，預設為[創意核准者使用者群組]

設定記錄器 configuration-loggers

AEM Java記錄檔定義為OSGi設定，因此會使用執行模式資料夾鎖定特定AEMas a Cloud Service環境。

透過Sling LogManager Factory的OSGi設定為自訂Java套件設定Java記錄。 有兩個支援的設定屬性：

OSGi設定屬性
說明
org.apache.sling.commons.log.names
要收集其記錄陳述式的Java套件。
org.apache.sling.commons.log.level
記錄Java套件的記錄層級，由org.apache.sling.commons.log.names指定

變更其他LogManager OSGi設定屬性可能會導致AEMas a Cloud Service的可用性問題。

以下是建議的記錄設定範例(使用預留位置Java套件： com.example)作為三種AEMas a Cloud Service環境型別。

開發 development

/apps/my-app/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": "debug"
}

測試 stage

/apps/my-app/config.stage/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": "warn"
}

生產 productiomn

/apps/my-app/config.prod/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": "error"
}

AEM HTTP要求記錄 aem-http-request-logging

AEMas a Cloud Service的HTTP請求記錄可讓您依時間順序深入分析向AEM提出的HTTP請求及其HTTP回應。 此記錄有助於瞭解向AEM發出的HTTP請求，以及這些請求被處理和回應的順序。

瞭解此記錄的關鍵在於透過其ID （以方括弧中的數值表示）對應HTTP請求和回應配對。 通常請求及其對應的回應會在記錄中於其他HTTP請求和回應之間插入。

紀錄範例

29/Apr/2020:19:14:21 +0000 [137] > POST /conf/global/settings/dam/adminui-extension/metadataprofile/ HTTP/1.1 [cm-p1234-e5678-aem-author-59555cb5b8-q7l9s]
...
29/Apr/2020:19:14:22 +0000 [139] > GET /mnt/overlay/dam/gui/content/processingprofilepage/metadataprofiles/editor.html/conf/global/settings/dam/adminui-extension/metadataprofile/main HTTP/1.1 [cm-p1234-e5678-aem-author-59555cb5b8-q7l9s]
...
29/Apr/2020:19:14:21 +0000 [137] <- 201 text/html 111ms [cm-p1234-e5678-aem-author-59555cb5b8-q7l9s]
...
29/Apr/2020:19:14:22 +0000 [139] <- 200 text/html;charset=utf-8 637ms [cm-p1234-e5678-aem-author-59555cb5b8-q7l9s]

記錄格式

日期和時間
2020年4月29日:19:14:21 +0000
請求/回應配對ID
[137]
HTTP 方法
POST
URL
/conf/global/settings/dam/adminui-extension/metadataprofile/
通訊協定
HTTP/1.1
AEMas a Cloud Service節點ID
[cm-p1234-e5678-aem-author-59555cb5b8-q7l9s]

設定記錄 configuring-the-log

AEM HTTP請求記錄檔無法以AEMas a Cloud Service設定。

AEM HTTP存取記錄 aem-http-access-logging

AEM as a Cloud Service HTTP存取記錄會依時間順序顯示HTTP要求。 每個記錄專案代表存取AEM的HTTP要求。

此記錄有助於快速瞭解向AEM發出的HTTP要求（如果這些要求通過檢視隨附的HTTP回應狀態代碼成功）以及HTTP要求完成所需的時間。 此記錄檔也可依使用者篩選記錄檔專案，有助於對特定使用者的活動進行除錯。

紀錄輸出範例

cm-p1234-e26813-aem-author-59555cb5b8-8kgr2 - example@adobe.com 30/Apr/2020:17:37:14 +0000  "GET /libs/granite/ui/references/clientlibs/references.lc-5188e85840c529149e6cd29d94e74ad5-lc.min.css HTTP/1.1" 200 1141 "https://author-p10711-e26813.adobeaemcloud.com/mnt/overlay/dam/gui/content/assets/metadataeditor.external.html?item=/content/dam/en/images/example.jpeg&_charset_=utf8" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/81.0.4044.122 Safari/537.36"
cm-p1234-e26813-aem-author-59555cb5b8-8kgr2 - example@adobe.com 30/Apr/2020:17:37:14 +0000  "GET /libs/dam/gui/coral/components/admin/customthumb/clientlibs.lc-60e4443805c37afa0c74b674b141f1df-lc.min.css HTTP/1.1" 200 809 "https://author-p10711-e26813.adobeaemcloud.com/mnt/overlay/dam/gui/content/assets/metadataeditor.external.html?item=/content/dam/en/images/example.jpeg&_charset_=utf8" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/81.0.4044.122 Safari/537.36"
cm-p1234-e26813-aem-author-59555cb5b8-8kgr2 - example@adobe.com 30/Apr/2020:17:37:14 +0000  "GET /libs/dam/gui/coral/components/admin/metadataeditor/clientlibs/metadataeditor.lc-4a2226d8232f8b7ab27d24820b9ddd64-lc.min.js HTTP/1.1" 200 7965 "https://author-p10711-e26813.adobeaemcloud.com/mnt/overlay/dam/gui/content/assets/metadataeditor.external.html?item=/content/dam/en/images/example.jpeg&_charset_=utf8" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/81.0.4044.122 Safari/537.36"
AEMas a Cloud Service節點ID
cm-p1235-e2644-aem-author-59555cb5b8-8kgr2
使用者端的IP位址
-
使用者
myuser@adobe.com
日期和時間
2020年4月30日:17:37:14 +0000
HTTP方法
GET
URL
/libs/granite/ui/references/clientlibs/references.lc-5188e85840c529149e6cd29d94e74ad5-lc.min.css
通訊協定
HTTP/1.1
HTTP回應狀態
200
回應內文的大小（以位元組為單位）
1141
反向連結
"https://author-p1234-e4444.adobeaemcloud.com/mnt/overlay/dam/gui/content/assets/metadataeditor.external.html?item=/content/dam/wknd/en/adventures/surf-camp-in-costa-rica/adobestock_266405335.jpeg&_charset_=utf8"
使用者代理
"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/81.0.4044.122 Safari/537.36"

設定HTTP存取記錄檔 configuring-the-http-access-log

無法在AEMas a Cloud Service中設定HTTP存取記錄檔。

Apache Web Server和Dispatcher記錄 apache-web-server-and-dispatcher-logging

AEMas a Cloud Service在發佈上為Apache Web Server和Dispatcher層提供三個記錄：

  • Apache HTTPD Web Server存取記錄
  • Apache HTTPD Web Server錯誤記錄
  • Dispatcher記錄

這些記錄檔僅適用於發佈階層。

這組記錄提供在請求到達AEM應用程式之前，AEMas a Cloud Service發佈層級的HTTP請求見解。 這很有必要瞭解，因為理想情況下，對發佈層級伺服器的大部分HTTP請求都是由Apache HTTPD Web Server和AEM Dispatcher快取的內容所提供，而且絕對不會連線AEM應用程式本身。 因此，AEM Java、要求或存取記錄檔中並沒有這些要求的記錄陳述式。

Apache HTTPD Web Server存取記錄檔 apache-httpd-web-server-access-log

Apache HTTP Web Server存取記錄檔為到達發佈層的Web伺服器/Dispatcher的每個HTTP請求提供陳述式。 從上游CDN提供的請求不會反映在這些記錄中。

請參閱下列連結中有關錯誤記錄格式的資訊： 官方apache檔案.

紀錄輸出範例

cm-p1234-e5678-aem-publish-b86c6b466-qpfvp - - 17/Jul/2020:09:14:41 +0000  "GET /etc.clientlibs/wknd/clientlibs/clientlib-site/resources/images/favicons/favicon-32.png HTTP/1.1" 200 715 "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:78.0) Gecko/20100101 Firefox/78.0"
cm-p1234-e5678-aem-publish-b86c6b466-qpfvp - - 17/Jul/2020:09:14:41 +0000  "GET /etc.clientlibs/wknd/clientlibs/clientlib-site/resources/images/favicons/favicon-512.png HTTP/1.1" 200 9631 "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:78.0) Gecko/20100101 Firefox/78.0"
cm-p1234-e5678-aem-publish-b86c6b466-qpfvp - - 17/Jul/2020:09:14:42 +0000  "GET /etc.clientlibs/wknd/clientlibs/clientlib-site/resources/images/country-flags/US.svg HTTP/1.1" 200 810 "https://publish-p6902-e30226.adobeaemcloud.com/content/wknd/us/en.html" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:78.0) Gecko/20100101 Firefox/78.0"

記錄格式

AEM as a Cloud Service節點ID
cm-p1234-e26813-aem-publish-5c787687c-lqlxr
使用者端的IP位址
-
使用者
-
日期和時間
2020年5月01日:00:09:46 +0000
HTTP 方法
GET
URL
/content/example.html
通訊協定
HTTP/1.1
HTTP回應狀態
200
大小
310
Referer
-
使用者代理
「Mozilla/5.0 (Macintosh；Intel Mac OS X 10_15_4) AppleWebKit/537.36 （KHTML，如Gecko） Chrome/81.0.4044.122 Safari/537.36」

設定Apache HTTPD Web Server存取記錄檔 configuring-the-apache-httpd-webs-server-access-log

此記錄檔無法在AEMas a Cloud Service設定。

Apache HTTPD Web Server錯誤記錄 apache-httpd-web-server-error-log

Apache HTTP Web Server錯誤記錄針對發佈層的Web伺服器/Dispatcher中的每個錯誤提供陳述式。

請參閱下列連結中有關錯誤記錄格式的資訊： 官方apache檔案.

紀錄輸出範例

Fri Jul 17 02:19:48.093820 2020 [mpm_worker:notice] [pid 1:tid 140272153361288] [cm-p1234-e30226-aem-publish-b86c6b466-b9427] AH00292: Apache/2.4.43 (Unix) Communique/4.3.4-20200424 mod_qos/11.63 configured -- resuming normal operations
Fri Jul 17 02:19:48.093874 2020 [core:notice] [pid 1:tid 140272153361288] [cm-p1234-e30226-aem-publish-b86c6b466-b9427] AH00094: Command line: 'httpd -d /etc/httpd -f /etc/httpd/conf/httpd.conf -D FOREGROUND -D ENVIRONMENT_PROD'
Fri Jul 17 02:29:34.517189 2020 [mpm_worker:notice] [pid 1:tid 140293638175624] [cm-p1234-e30226-aem-publish-b496f64bf-5vckp] AH00295: caught SIGTERM, shutting down

記錄格式

日期和時間
2017年7月17日星期五02:16:2020年42.608913
事件層級
[mpm_worker：notice]
處理序ID
[pid 1：tid 140715149343624]
Pod名稱
[cm-p1234-e56789-aem-publish-b86c6b466-qpfvp]
訊息
AH00094：命令列： 'httpd -d /etc/httpd -f /etc/httpd/conf/httpd.conf -D FOREGROUND -D

設定Apache HTTPD Web Server錯誤記錄 configuring-the-apache-httpd-web-server-error-log

mod_rewrite日誌層級由檔案中的變數REWRITE_LOG_LEVEL定義 conf.d/variables/global.var.

可將其設為error、warn、info、debug和trace1 - trace8，預設值為warn。 若要偵錯RewriteRules，建議將記錄層級提升為trace2。 建議您使用針對重寫規則進行偵錯 Dispatcher SDK. AEMas a Cloud Service的最大記錄層級為 debug. 因此，目前不可能有效地在雲端中偵錯重寫規則。

請參閱 mod_rewrite模組檔案 以取得詳細資訊。

若要為每個環境設定記錄層級，請在global.var檔案中使用適當的條件分支，如下所述：

Define REWRITE_LOG_LEVEL debug

<IfDefine ENVIRONMENT_STAGE>
  ...
  Define REWRITE_LOG_LEVEL warn
  ...
</IfDefine>
<IfDefine ENVIRONMENT_PROD>
  ...
  Define REWRITE_LOG_LEVEL error
  ...
</IfDefine>

Dispatcher記錄檔 dispatcher-log

範例

[17/Jul/2020:23:48:06 +0000] [I] [cm-p12904-e25628-aem-publish-6c5f7c9dbd-mzcvr] "GET /content/wknd/us/en/adventures.html" - 475ms [publishfarm/0] [action miss] "publish-p12904-e25628.adobeaemcloud.com"
[17/Jul/2020:23:48:07 +0000] [I] [cm-p12904-e25628-aem-publish-6c5f7c9dbd-mzcvr] "GET /content/wknd/us/en/adventures/climbing-new-zealand/_jcr_content/root/responsivegrid/carousel/item_1571266094599.coreimg.jpeg/1473680817282/sport-climbing.jpeg" 302 10ms [publishfarm/0] [action none] "publish-p12904-e25628.adobeaemcloud.com"
[17/Jul/2020:23:48:07 +0000] [I] [cm-p12904-e25628-aem-publish-6c5f7c9dbd-mzcvr] "GET /content/wknd/us/en/adventures/ski-touring-mont-blanc/_jcr_content/root/responsivegrid/carousel/item_1571168419252.coreimg.jpeg/1572047288089/adobestock-238230356.jpeg" 302 11ms [publishfarm/0] [action none] "publish-p12904-e25628.adobeaemcloud.com"

記錄格式

日期和時間
[2020年7月17日:23:48:16 +0000]
Pod名稱
[cm-p12904-e25628-aem-publish-6c5f7c9dbd-mzcvr]
通訊協定
GET
URL
/content/experience-fragments/wknd/language-masters/en/contributors/sofia-sjoeberg/master/_jcr_content/root/responsivegrid/image.coreimg.100.500.jpeg/1572236359031/ayo-ogunseinde-237739.jpeg
Dispatcher回應狀態代碼
/content/experience-fragments/wknd/language-masters/en/contributors/sofia-sjoeberg/master/_jcr_content/root/responsivegrid/image.coreimg.100.500.jpeg/1572236359031/ayo-ogunseinde-237739.jpeg
持續時間
1949毫秒
陣列
[publishfarm/0]
快取狀態
[動作未命中]
主機
"publish-p12904-e25628.adobeaemcloud.com"

設定Dispatcher錯誤記錄檔 configuring-the-dispatcher-error-log

Dispatcher記錄層級是由檔案中的變數DISP_LOG_LEVEL所定義 conf.d/variables/global.var.

它可以設定為error、warn、info、debug和trace1，預設值為warn。

雖然Dispatcher記錄支援數個其他層級的記錄粒度，但AEMas a Cloud Service建議使用下述層級。

若要為每個環境設定記錄層級，請在 global.var 檔案，如下所述：

Define DISP_LOG_LEVEL debug

<IfDefine ENVIRONMENT_STAGE>
  ...
  Define DISP_LOG_LEVEL warn
  ...
</IfDefine>
<IfDefine ENVIRONMENT_PROD>
  ...
  Define DISP_LOG_LEVEL error
  ...
</IfDefine>
NOTE
對於AEMas a Cloud Service環境，偵錯是最高詳細程度等級。 不支援追蹤記錄層級，因此您在雲端環境中工作時應該避免進行設定。

CDN記錄 cdn-log

AEMas a Cloud Service提供對CDN記錄的存取權，這對使用案例（包括快取命中比率最佳化）很有用。 無法自訂CDN記錄格式，且沒有將其設定為不同模式（例如info、warn或error）的概念。

CDN記錄檔將轉送至Splunk，以處理新的Splunk轉送支援票證請求；已啟用Splunk轉送的客戶未來可以新增CDN記錄檔。

範例

{
"timestamp": "2023-05-26T09:20:01+0000",
"ttfb": 19,
"cli_ip": "147.160.230.112",
"cli_country": "CH",
"rid": "974e67f6",
"req_ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.0.3 Safari/605.1.15",
"host": "example.com",
"url": "/content/hello.png",
"method": "GET",
"res_ctype": "image/png",
"cache": "PASS",
"status": 200,
"res_age": 0,
"pop": "PAR",
"rules": "match=Enable-SQL-Injection-and-XSS-waf-rules-globally,waf=SQLI,action=blocked"
}

記錄格式

CDN記錄與其他記錄不同，因為它會遵循JSON格式。

欄位名稱
說明
timestamp
TLS 終止後要求開始的時間
ttfb
首位元組時間 (Time To First Byte) 的縮寫。發出要求開始到回應內文開始串流的時間之間的時間間隔。
cli_ip
用戶端 IP 位址。
cli_country
雙字母 ISO 3166-1 用戶端國家/地區的 alpha-2 國家/地區代碼。
rid
用於唯一識別要求的要求標頭的值。
req_ua
負責發出特定 HTTP 要求的使用者代理程式。
主機
發送要求的目標機構。
url
包括查詢參數的完整路徑。
方法
用戶端傳送的 HTTP 方法，例如「GET」或「POST」。
res_ctype
此內容類型用於指明資源的原始媒體類型。
cache
快取的狀態。可能的值包括 HIT、MISS 或 PASS
狀態
作為整數值的 HTTP 狀態代碼。
res_age
回應已經 (在所有的節點) 快取的時間量 (以秒為單位)。
pop
CDN 快取伺服器的資料中心。
rules
任何相符專案的名稱 流量篩選器規則 和WAF標幟，也會指出相符專案是否導致區塊。 若沒有相符的規則，則為空白。

如何存取記錄檔 how-to-access-logs

雲端環境 cloud-environments

您可以透過Cloud Manager介面下載，或使用命令列介面在命令列追蹤記錄，來存取雲端服務的AEMas a Cloud ServiceAdobe I/O記錄。 如需詳細資訊，請參閱 Cloud Manager記錄檔案.

其他發佈區域的記錄 logs-for-additional-publish-regions

如果針對特定環境啟用了其他發佈區域，則可以從Cloud Manager下載每個區域的記錄，如上所述。

其他發佈區域的AEM記錄和Dispatcher記錄將在環境ID之後的前3個字母中指定區域，例如 nld2 在下列範例中，此範例是指位於荷蘭的其他AEM發佈執行個體：

cm-p7613-e12700-nld2-aem-publish-bcbb77549-5qmmt 127.0.0.1 - 07/Nov/2023:23:57:11 +0000 "HEAD /libs/granite/security/currentuser.json HTTP/1.1" 200 - "-" "Java/11.0.19"

本機 SDK local-sdk

AEMas a Cloud ServiceSDK提供記錄檔以支援本機開發。

AEM記錄檔位於資料夾中 crx-quickstart/logs，可檢視下列記錄檔：

  • AEM Java記錄檔： error.log
  • AEM HTTP要求記錄： request.log
  • AEM HTTP存取記錄： access.log

Apache層記錄（包括Dispatcher）位於容納Dispatcher的Docker容器中。 請參閱 Dispatcher檔案 以取得如何啟動Dispatcher的相關資訊。

擷取記錄檔：

  1. 在命令列中，輸入 docker ps 以列出您的容器

  2. 若要登入容器，請輸入"docker exec -it <container> /bin/sh「」，其中 <container> 是上一步的Dispatcher容器ID

  3. 導覽至下的快取根目錄 /mnt/var/www/html

  4. 記錄位於 /etc/httpd/logs

  5. Inspect記錄：可在XYZ資料夾下存取記錄，您可在此檢視以下記錄：

    • Apache HTTPD Web伺服器存取記錄 — httpd_access.log
    • Apache HTTPD Web伺服器錯誤記錄檔 — httpd_error.log
    • Dispatcher記錄 — dispatcher.log

記錄也直接列印到終端機輸出。 大多數情況下，這些記錄應為DEBUG，可通過在執行Docker時作為引數傳入Debug級別來完成。 例如：

DISP_LOG_LEVEL=Debug ./bin/docker_run.sh out docker.for.mac.localhost:4503 8080

偵錯生產和中繼 debugging-production-and-stage

在例外情況下，記錄層級需要變更以在中繼或生產環境中的更精細精細記錄。

雖然這是可能的，但需要變更Git中設定檔案的記錄層級（從Warn和Error到Debug），並執行部署至AEMas a Cloud Service以向環境註冊這些設定變更。

根據Debug所寫入的流量和記錄陳述式數量，這可能會導致對環境的效能造成不良影響，因此，建議對「中繼」和「生產」偵錯層級的變更如下：

  • 謹慎行事，並且只在絕對必要時進行
  • 已恢復至適當層級，並儘快重新部署

Splunk記錄 splunk-logs

擁有Splunk帳戶的客戶可透過客戶支援票證，要求將其AEM Cloud Service記錄轉送至適當的索引。 記錄資料等同於透過Cloud Manager記錄下載提供的資料，但客戶可能會發現使用Splunk產品中提供的查詢功能很方便。

與傳送至Splunk的記錄檔相關聯的網路頻寬會視為客戶網路I/O使用量的一部分。

CDN記錄檔將轉送至Splunk以處理新的支援票證請求；已啟用Splunk轉送的客戶未來將能夠新增CDN記錄檔。

啟用Splunk轉送 enabling-splunk-forwarding

在支援要求中，客戶應指出：

  • Splunk HEC端點位址。 此端點必須具有有效的SSL憑證且可公開存取。
  • Splunk索引
  • Splunk連線埠
  • Splunk HEC權杖。 另請參閱 此頁面 以取得詳細資訊。

以上屬性應該為每個相關的程式/環境型別組合指定。 例如，如果客戶想要開發、測試和生產環境，他們應該提供三組資訊，如下所示。

NOTE
不支援沙箱計畫環境的Splunk轉送。
NOTE
專用輸出 IP 位址無法提供 Splunk 轉送功能。

您應該確保初始請求除了階段/生產環境之外，還包含所有應該啟用的開發環境。 Splunk必須具有SSL憑證，且必須對外公開。

如果在初始請求後建立的任何新開發環境打算啟用Splunk轉送，但未啟用，則應提出其他請求。

另請注意，如果已經請求開發環境，則不在請求中的其他開發環境或甚至沙箱環境可能會啟用Splunk轉送，並且將共用Splunk索引。 客戶可以使用 aem_env_id 欄位以區分這些環境。

您將會找到客戶支援請求的範例：

方案123，生產環境

  • Splunk HEC端點位址： splunk-hec-ext.acme.com
  • Splunk索引：acme_123prod （客戶可以選擇想要的任何命名慣例）
  • Splunk連線埠：443
  • Splunk HEC權杖： ABC123

方案123，中繼環境

  • Splunk HEC端點位址： splunk-hec-ext.acme.com
  • Splunk索引： acme_123stage
  • Splunk連線埠：443
  • Splunk HEC權杖： ABC123

方案123，開發環境

  • Splunk HEC端點位址： splunk-hec-ext.acme.com
  • Splunk索引： acme_123dev
  • Splunk連線埠：443
  • Splunk HEC權杖： ABC123

每個環境使用相同的Splunk索引可能就足夠了，在這種情況下， aem_env_type 欄位可用於根據dev、stage和prod等值加以區分。 如果有多個開發環境， aem_env_id 欄位也可使用。 如果關聯的索引限制存取縮減的Splunk使用者集，則某些組織可能會為生產環境的記錄選擇單獨的索引。

紀錄專案範例如下：

aem_env_id: 1242
aem_env_type: dev
aem_program_id: 12314
aem_tier: author
file_path: /var/log/aem/error.log
host: 172.34.200.12
level: INFO
msg: [FelixLogListener] com.adobe.granite.repository Service [5091, [org.apache.jackrabbit.oak.api.jmx.SessionMBean]] ServiceEvent REGISTERED
orig_time: 16.07.2020 08:35:32.346
pod_name: aemloggingall-aem-author-77797d55d4-74zvt
splunk_customer: true
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab