本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
診斷適用於 Oracle 資料庫執行個體RDS的 問題
Oracle 資料庫包含可用來調查資料庫問題的故障性基礎架構。在 Oracle 術語中，problem (問題) 是嚴重錯誤，例如程式碼錯誤或資料損毀。Incident (事件) 則是發生問題。如果同樣的錯誤發生三次，則基礎結構會顯示這個問題的三個事件。如需詳細資訊，請參閱 Oracle 資料庫文件中的診斷和解決問題
Automatic Diagnostic Repository Command Interpreter （ADRCI） 公用程式是您用來管理診斷資料的 Oracle 命令列工具。例如，您可以使用這個工具來調查問題，並封裝診斷資料。incident package (事件套件) 包含事件或參考特定問題之所有事件的診斷資料。您可以將事件套件 (實作為 .zip 檔案) 上傳至 Oracle 支援。
為了提供受管服務體驗，Amazon RDS不提供對 的 Shell 存取ADRCI。若要為RDS適用於 Oracle 資料庫執行個體的 執行診斷任務，請使用 Amazon RDS套件 rdsadmin.rdsadmin_adrci_util。
透過使用 rdsadmin_adrci_util 中的函數，您可以列出並封裝問題和事件，也可以顯示追蹤檔案。所有函數都會傳回工作 ID。此 ID 構成日誌檔案名稱的一部分，其中包含ADRCI輸出，如 所示dbtask-。日誌檔案位於 BDUMP目錄中。您可以按照中所述的程序下載日誌檔案下載資料庫日誌檔案。task_id.log
診斷程序的常見參數
若要執行診斷任務，請使用 Amazon RDS套件 中的 函數rdsadmin.rdsadmin_adrci_util。以下即為該套件的常見參數。
| 參數名稱 | 資料類型 | 有效值 | 預設 | 必要 | 描述 |
|---|---|---|---|---|---|
|
|
數字 |
有效的事件 ID 或 null |
Null |
否 |
如果值為 null，則函數會顯示所有事件。如果值不是 null 且代表有效的事件 ID，則函數會顯示指定的事件。 |
|
|
數字 |
有效的問題 ID 或 null |
Null |
否 |
如果該值為 null，該函數會顯示所有問題。如果值不為 null 且代表有效的問題 ID，則函數會顯示指定的問題。 |
|
|
數字 |
大於 0 或 null 的有效整數 |
Null |
否 |
如果該值為空，則該函數最多顯示 50 個項目。如果該值不為 null，函數會顯示指定的數字。 |
列出事件
若要列出 Oracle 的診斷事件，請使用 Amazon RDS函數 rdsadmin.rdsadmin_adrci_util.list_adrci_incidents。您可以在基本或詳細模式中列出事件。依預設，此函數會列出最近 50 個事件。
此函數使用下列一般參數：
-
incident_id -
problem_id -
last
如果您指定 incident_id 和 problem_id，則 incident_id 會覆寫 problem_id。如需詳細資訊，請參閱診斷程序的常見參數。
此函數使用以下附加參數。
| 參數名稱 | 資料類型 | 有效值 | 預設 | 必要 | 描述 |
|---|---|---|---|---|---|
|
|
布林值 |
TRUE 或 FALSE * |
|
否 |
如果 |
如要列出所有事件，請查詢不含任何引數的 rdsadmin.rdsadmin_adrci_util.list_adrci_incidents 函數。此查詢會傳回任務 ID。
SQL> SELECT rdsadmin.rdsadmin_adrci_util.list_adrci_incidents AS task_id FROM DUAL; TASK_ID ------------------ 1590786706158-3126
或呼叫 rdsadmin.rdsadmin_adrci_util.list_adrci_incidents函數，而沒有任何引數，並將輸出儲存在SQL用戶端變數中。您可以在其他陳述式中使用變數。
SQL> VAR task_id VARCHAR2(80); SQL> EXEC :task_id := rdsadmin.rdsadmin_adrci_util.list_adrci_incidents; PL/SQL procedure successfully completed.
若要讀取日誌檔案，請呼叫 Amazon RDS 程序 rdsadmin.rds_file_util.read_text_file。提供任務 ID 做為檔案名稱的一部分。下列輸出顯示三個事件：53523、53522 和 53521。
SQL> SELECT * FROM TABLE(rdsadmin.rds_file_util.read_text_file('BDUMP', 'dbtask-'||:task_id||'.log')); TEXT ------------------------------------------------------------------------------------------------------------------------- 2020-05-29 21:11:46.193 UTC [INFO ] Listing ADRCI incidents. 2020-05-29 21:11:46.256 UTC [INFO ] ADR Home = /rdsdbdata/log/diag/rdbms/orcl_a/ORCL: ************************************************************************* INCIDENT_ID PROBLEM_KEY CREATE_TIME ----------- ----------------------------------------------------------- ---------------------------------------- 53523 ORA 700 [EVENT_CREATED_INCIDENT] [942] [SIMULATED_ERROR_003 2020-05-29 20:15:20.928000 +00:00 53522 ORA 700 [EVENT_CREATED_INCIDENT] [942] [SIMULATED_ERROR_002 2020-05-29 20:15:15.247000 +00:00 53521 ORA 700 [EVENT_CREATED_INCIDENT] [942] [SIMULATED_ERROR_001 2020-05-29 20:15:06.047000 +00:00 3 rows fetched 2020-05-29 21:11:46.256 UTC [INFO ] The ADRCI incidents were successfully listed. 2020-05-29 21:11:46.256 UTC [INFO ] The task finished successfully. 14 rows selected.
若要列出特定事件，請使用 incident_id 參數指定其 ID。在下列範例中，您只查詢事件 53523 的日誌檔案。
SQL> EXEC :task_id := rdsadmin.rdsadmin_adrci_util.list_adrci_incidents(incident_id=>53523); PL/SQL procedure successfully completed. SQL> SELECT * FROM TABLE(rdsadmin.rds_file_util.read_text_file('BDUMP', 'dbtask-'||:task_id||'.log')); TEXT ------------------------------------------------------------------------------------------------------------------ 2020-05-29 21:15:25.358 UTC [INFO ] Listing ADRCI incidents. 2020-05-29 21:15:25.426 UTC [INFO ] ADR Home = /rdsdbdata/log/diag/rdbms/orcl_a/ORCL: ************************************************************************* INCIDENT_ID PROBLEM_KEY CREATE_TIME -------------------- ----------------------------------------------------------- --------------------------------- 53523 ORA 700 [EVENT_CREATED_INCIDENT] [942] [SIMULATED_ERROR_003 2020-05-29 20:15:20.928000 +00:00 1 rows fetched 2020-05-29 21:15:25.427 UTC [INFO ] The ADRCI incidents were successfully listed. 2020-05-29 21:15:25.427 UTC [INFO ] The task finished successfully. 12 rows selected.
列出問題
若要列出 Oracle 的診斷問題，請使用 Amazon RDS函數 rdsadmin.rdsadmin_adrci_util.list_adrci_problems。
依預設，該函數會列出 50 個最近的問題。
此函數使用一般參數problem_id 和 last。如需詳細資訊，請參閱診斷程序的常見參數。
若要取得所有問題的任務 ID，請呼叫 rdsadmin.rdsadmin_adrci_util.list_adrci_problems函數而不使用任何引數，並將輸出儲存在SQL用戶端變數中。
SQL> EXEC :task_id := rdsadmin.rdsadmin_adrci_util.list_adrci_problems; PL/SQL procedure successfully completed.
若要讀取日誌檔案，請呼叫 rdsadmin.rds_file_util.read_text_file 函數，並提供任務 ID 做為檔案名稱的一部分。在下列輸出中，日誌檔案會顯示三個問題：1、2 和 3。
SQL> SELECT * FROM TABLE(rdsadmin.rds_file_util.read_text_file('BDUMP', 'dbtask-'||:task_id||'.log')); TEXT ---------------------------------------------------------------------------------------------------------------------- 2020-05-29 21:18:50.764 UTC [INFO ] Listing ADRCI problems. 2020-05-29 21:18:50.829 UTC [INFO ] ADR Home = /rdsdbdata/log/diag/rdbms/orcl_a/ORCL: ************************************************************************* PROBLEM_ID PROBLEM_KEY LAST_INCIDENT LASTINC_TIME ---------- ----------------------------------------------------------- ------------- --------------------------------- 2 ORA 700 [EVENT_CREATED_INCIDENT] [942] [SIMULATED_ERROR_003 53523 2020-05-29 20:15:20.928000 +00:00 3 ORA 700 [EVENT_CREATED_INCIDENT] [942] [SIMULATED_ERROR_002 53522 2020-05-29 20:15:15.247000 +00:00 1 ORA 700 [EVENT_CREATED_INCIDENT] [942] [SIMULATED_ERROR_001 53521 2020-05-29 20:15:06.047000 +00:00 3 rows fetched 2020-05-29 21:18:50.829 UTC [INFO ] The ADRCI problems were successfully listed. 2020-05-29 21:18:50.829 UTC [INFO ] The task finished successfully. 14 rows selected.
在下列範例中，您只列出問題 3。
SQL> EXEC :task_id := rdsadmin.rdsadmin_adrci_util.list_adrci_problems(problem_id=>3); PL/SQL procedure successfully completed.
若要讀取問題 3 的日誌檔案，請呼叫 rdsadmin.rds_file_util.read_text_file。提供任務 ID 做為檔案名稱的一部分。
SQL> SELECT * FROM TABLE(rdsadmin.rds_file_util.read_text_file('BDUMP', 'dbtask-'||:task_id||'.log')); TEXT ------------------------------------------------------------------------- 2020-05-29 21:19:42.533 UTC [INFO ] Listing ADRCI problems. 2020-05-29 21:19:42.599 UTC [INFO ] ADR Home = /rdsdbdata/log/diag/rdbms/orcl_a/ORCL: ************************************************************************* PROBLEM_ID PROBLEM_KEY LAST_INCIDENT LASTINC_TIME ---------- ----------------------------------------------------------- ------------- --------------------------------- 3 ORA 700 [EVENT_CREATED_INCIDENT] [942] [SIMULATED_ERROR_002 53522 2020-05-29 20:15:15.247000 +00:00 1 rows fetched 2020-05-29 21:19:42.599 UTC [INFO ] The ADRCI problems were successfully listed. 2020-05-29 21:19:42.599 UTC [INFO ] The task finished successfully. 12 rows selected.
建立事件套件
您可以使用 Amazon RDS函數 建立事件套件rdsadmin.rdsadmin_adrci_util.create_adrci_package。該輸出是一個您可以提供給 Oracle 支援的 .zip 檔案。
此函數使用下列一般參數：
-
problem_id -
incident_id
請務必指定上述其中一個參數。如果您同時指定兩個參數，則 incident_id 會覆寫 problem_id。如需詳細資訊，請參閱診斷程序的常見參數。
若要為特定事件建立套件，請使用 rdsadmin.rdsadmin_adrci_util.create_adrci_package incident_id 參數呼叫 Amazon RDS函數。下列範例會為事件 53523 建立套件。
SQL> EXEC :task_id := rdsadmin.rdsadmin_adrci_util.create_adrci_package(incident_id=>53523); PL/SQL procedure successfully completed.
若要讀取日誌檔案，請呼叫 rdsadmin.rds_file_util.read_text_file。您可以提供任務 ID 做為檔案名稱的一部分。該輸出會顯示您產生的事件套件 ORA700EVE_20200529212043_COM_1.zip。
SQL> SELECT * FROM TABLE(rdsadmin.rds_file_util.read_text_file('BDUMP', 'dbtask-'||:task_id||'.log')); TEXT -------------------------------------------------------------------------------------------------------------------------------------- 2020-05-29 21:20:43.031 UTC [INFO ] The ADRCI package is being created. 2020-05-29 21:20:47.641 UTC [INFO ] Generated package 1 in file /rdsdbdata/log/trace/ORA700EVE_20200529212043_COM_1.zip, mode complete 2020-05-29 21:20:47.642 UTC [INFO ] The ADRCI package was successfully created. 2020-05-29 21:20:47.642 UTC [INFO ] The task finished successfully.
若要封裝特定問題的診斷資料，請使用 problem_id 參數指定其 ID。在下列範例中，您只封裝問題 3 的資料。
SQL> EXEC :task_id := rdsadmin.rdsadmin_adrci_util.create_adrci_package(problem_id=>3); PL/SQL procedure successfully completed.
若要讀取任務輸出，請呼叫 rdsadmin.rds_file_util.read_text_file，提供任務 ID 做為檔案名稱的一部分。該輸出會顯示您產生的事件套件 ORA700EVE_20200529212111_COM_1.zip。
SQL> SELECT * FROM TABLE(rdsadmin.rds_file_util.read_text_file('BDUMP', 'dbtask-'||:task_id||'.log')); TEXT ------------------------------------------------------------------------------------------------------------------------------------------------------------ 2020-05-29 21:21:11.050 UTC [INFO ] The ADRCI package is being created. 2020-05-29 21:21:15.646 UTC [INFO ] Generated package 2 in file /rdsdbdata/log/trace/ORA700EVE_20200529212111_COM_1.zip, mode complete 2020-05-29 21:21:15.646 UTC [INFO ] The ADRCI package was successfully created. 2020-05-29 21:21:15.646 UTC [INFO ] The task finished successfully.
您也可以下載日誌檔案。如需詳細資訊，請參閱下載資料庫日誌檔案。
顯示追蹤檔案
您可以使用 Amazon RDS函數rdsadmin.rdsadmin_adrci_util.show_adrci_tracefile，在追蹤目錄下列出追蹤檔案，並在目前ADR首頁下列出所有事件目錄。您也可以顯示追蹤檔案和事件追蹤檔案的內容。
此函數使用下列參數。
| 參數名稱 | 資料類型 | 有效值 | 預設 | 必要 | 描述 |
|---|---|---|---|---|---|
|
|
varchar2 |
有效的追蹤檔案名稱 |
Null |
否 |
如果值為 null，函數會顯示所有追蹤檔案。如果它不是 null，該函數顯示指定的檔案。 |
若要顯示追蹤檔案，請呼叫 Amazon RDS函數 rdsadmin.rdsadmin_adrci_util.show_adrci_tracefile。
SQL> EXEC :task_id := rdsadmin.rdsadmin_adrci_util.show_adrci_tracefile; PL/SQL procedure successfully completed.
若要列出追蹤檔案名稱，請呼叫 Amazon RDS 程序 rdsadmin.rds_file_util.read_text_file，並提供任務 ID 作為檔案名稱的一部分。
SQL> SELECT * FROM TABLE(rdsadmin.rds_file_util.read_text_file('BDUMP', 'dbtask-'||:task_id||'.log')) WHERE TEXT LIKE '%/alert_%'; TEXT --------------------------------------------------------------- diag/rdbms/orcl_a/ORCL/trace/alert_ORCL.log.2020-05-28 diag/rdbms/orcl_a/ORCL/trace/alert_ORCL.log.2020-05-27 diag/rdbms/orcl_a/ORCL/trace/alert_ORCL.log.2020-05-26 diag/rdbms/orcl_a/ORCL/trace/alert_ORCL.log.2020-05-25 diag/rdbms/orcl_a/ORCL/trace/alert_ORCL.log.2020-05-24 diag/rdbms/orcl_a/ORCL/trace/alert_ORCL.log.2020-05-23 diag/rdbms/orcl_a/ORCL/trace/alert_ORCL.log.2020-05-22 diag/rdbms/orcl_a/ORCL/trace/alert_ORCL.log.2020-05-21 diag/rdbms/orcl_a/ORCL/trace/alert_ORCL.log 9 rows selected.
在下列範例中，您會為 產生輸出alert_ORCL.log。
SQL> EXEC :task_id := rdsadmin.rdsadmin_adrci_util.show_adrci_tracefile('diag/rdbms/orcl_a/ORCL/trace/alert_ORCL.log'); PL/SQL procedure successfully completed.
若要讀取日誌檔案，請呼叫 rdsadmin.rds_file_util.read_text_file。提供任務 ID 做為檔案名稱的一部分。輸出顯示 alert_ORCL.log 的前 10 行。
SQL> SELECT * FROM TABLE(rdsadmin.rds_file_util.read_text_file('BDUMP', 'dbtask-'||:task_id||'.log')) WHERE ROWNUM <= 10; TEXT ----------------------------------------------------------------------------------------- 2020-05-29 21:24:02.083 UTC [INFO ] The trace files are being displayed. 2020-05-29 21:24:02.128 UTC [INFO ] Thu May 28 23:59:10 2020 Thread 1 advanced to log sequence 2048 (LGWR switch) Current log# 3 seq# 2048 mem# 0: /rdsdbdata/db/ORCL_A/onlinelog/o1_mf_3_hbl2p8xs_.log Thu May 28 23:59:10 2020 Archived Log entry 2037 added for thread 1 sequence 2047 ID 0x5d62ce43 dest 1: Fri May 29 00:04:10 2020 Thread 1 advanced to log sequence 2049 (LGWR switch) Current log# 4 seq# 2049 mem# 0: /rdsdbdata/db/ORCL_A/onlinelog/o1_mf_4_hbl2qgmh_.log Fri May 29 00:04:10 2020 10 rows selected.
您也可以下載日誌檔案。如需詳細資訊，請參閱下載資料庫日誌檔案。
