終止支援通知：2026 年 5 月 31 日， AWS 將終止對 的支援 AWS Panorama。2026 年 5 月 31 日之後，您將無法再存取 AWS Panorama 主控台或 AWS Panorama 資源。如需詳細資訊，請參閱[AWS Panorama 終止支援](https://docs.aws.amazon.com/panorama/latest/dev/panorama-end-of-support.html)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 檢視 AWS Panorama 日誌
<a name="monitoring-logging"></a>

AWS Panorama 向 Amazon CloudWatch Logs 報告應用程式和系統事件。當您遇到問題時，您可以使用事件日誌來協助偵錯 AWS Panorama 應用程式或疑難排解應用程式的組態。

**在 CloudWatch Logs 中檢視日誌**

1. 開啟 [ CloudWatch Logs 主控台的日誌群組頁面](https://console.aws.amazon.com/cloudwatch/home#logsV2:log-groups)。

1. 在下列群組中尋找 AWS Panorama 應用程式和設備日誌：

****
   + **裝置日誌** – `/aws/panorama/devices/device-id`
   + **應用程式日誌** – `/aws/panorama/devices/device-id/applications/instance-id`

當您在更新系統軟體後重新佈建設備時，您也可以[檢視佈建 USB 隨身碟上的日誌](#monitoring-logging-provisioning)。

**Topics**
+ [檢視裝置日誌](#monitoring-logging-device)
+ [檢視應用程式日誌](#monitoring-logging-application)
+ [設定應用程式日誌](#monitoring-logging-configuration)
+ [檢視佈建日誌](#monitoring-logging-provisioning)
+ [從裝置輸出日誌](#monitoring-logging-egress)

## 檢視裝置日誌
<a name="monitoring-logging-device"></a>

AWS Panorama 設備會為裝置建立日誌群組，並為您部署的每個應用程式執行個體建立群組。裝置日誌包含應用程式狀態、軟體升級和系統組態的相關資訊。

**裝置日誌 – `/aws/panorama/devices/device-id`**
+ `occ_log` – 控制器程序的輸出。此程序會協調應用程式部署，並報告每個應用程式執行個體節點的狀態。
+ `ota_log` – 從協調over-the-air (OTA) 軟體升級的程序輸出。
+ `syslog` – 裝置 syslog 程序的輸出，可擷取程序之間傳送的訊息。
+ `kern_log` – 來自裝置 Linux 核心的事件。
+ `logging_setup_logs` – 從設定 CloudWatch Logs 代理程式的程序輸出。
+ `cloudwatch_agent_logs` – 從 CloudWatch Logs 代理程式輸出。
+ `shadow_log` – 從[AWS IoT 裝置影子](https://docs.aws.amazon.com/iot/latest/developerguide/iot-device-shadows.html)輸出。

## 檢視應用程式日誌
<a name="monitoring-logging-application"></a>

應用程式執行個體的日誌群組包含每個節點的日誌串流，以節點命名。

**應用程式日誌 – `/aws/panorama/devices/device-id/applications/instance-id`**
+ **程式碼** – 從應用程式程式碼和 AWS Panorama 應用程式 SDK 輸出。從 彙總應用程式日誌`/opt/aws/panorama/logs`。
+ **模型** – 來自使用模型協調推論請求之程序的輸出。
+ **串流** – 從從攝影機串流解碼視訊的程序輸出。
+ **顯示** – 轉譯 HDMI 連接埠視訊輸出的程序輸出。
+ `mds` – 來自設備中繼資料伺服器的日誌。
+ `console_output` – 從程式碼容器擷取標準輸出和錯誤串流。

如果您在 CloudWatch Logs 中看不到日誌，請確認您位於正確的 AWS 區域。若是如此，設備與 AWS 的連線或[設備 AWS Identity and Access Management (IAM) 角色的](permissions-services.md)許可可能會發生問題。

## 設定應用程式日誌
<a name="monitoring-logging-configuration"></a>

設定 Python 記錄器將日誌檔案寫入 `/opt/aws/panorama/logs`。設備會將日誌從此位置串流至 CloudWatch Logs。若要避免使用過多的磁碟空間，請使用檔案大小上限為 10 MiB，備份計數為 1。下列範例顯示建立記錄器的方法。

**Example [application.py](https://github.com/awsdocs/aws-panorama-developer-guide/blob/main/sample-apps/aws-panorama-sample/packages/123456789012-SAMPLE_CODE-1.0/application.py#L181)：// – Logger 組態**  

```
def get_logger(name=__name__,level=logging.INFO):
    logger = logging.getLogger(name)
    logger.setLevel(level)
    LOG_PATH = '/opt/aws/panorama/logs'
    handler = RotatingFileHandler("{}/app.log".format(LOG_PATH), maxBytes=10000000, backupCount=1)
    formatter = logging.Formatter(fmt='%(asctime)s %(levelname)-8s %(message)s',
                                    datefmt='%Y-%m-%d %H:%M:%S')
    handler.setFormatter(formatter)
    logger.addHandler(handler)
    return logger
```

在全域範圍內初始化記錄器，並將其用於整個應用程式程式碼。

**Example [application.py](https://github.com/awsdocs/aws-panorama-developer-guide/blob/main/sample-apps/aws-panorama-sample/packages/123456789012-SAMPLE_CODE-1.0/application.py#L205) – 初始化記錄器**  

```
def main():
    try:
        logger.info("INITIALIZING APPLICATION")
        app = Application()
        logger.info("PROCESSING STREAMS")
        while True:
            app.process_streams()
            # turn off debug logging after 150 loops
            if logger.getEffectiveLevel() == logging.DEBUG and app.frame_num == 150:
                logger.setLevel(logging.INFO)
    except:
        logger.exception('Exception during processing loop.')

logger = get_logger(level=logging.INFO)
main()
```

## 檢視佈建日誌
<a name="monitoring-logging-provisioning"></a>

在佈建期間，AWS Panorama 設備會將日誌複製到您用來將組態封存傳輸至設備的 USB 磁碟機。使用這些日誌來疑難排解具有最新軟體版本之設備上的佈建問題。

**重要**  
佈建日誌可供更新至軟體版本 4.3.23 或更新版本的設備使用。

**應用程式記錄**
+ `/panorama/occ.log` – AWS Panorama 控制器軟體日誌。
+ `/panorama/ota_agent.log` – AWS Panorama over-the-air更新代理程式日誌。
+ `/panorama/syslog.log` – Linux 系統日誌。
+ `/panorama/kern.log` – Linux 核心日誌。

## 從裝置輸出日誌
<a name="monitoring-logging-egress"></a>

如果您的裝置和應用程式日誌未出現在 CloudWatch Logs 中，您可以使用 USB 隨身碟從裝置取得加密的日誌映像。AWS Panorama 服務團隊可以代表您解密日誌並協助偵錯。

### 先決條件
<a name="monitoring-logging-egress-prerequisites"></a>

若要遵循程序，您將需要下列硬體：
+ **USB 隨身碟** – FAT32-formatted的 USB 隨身碟，具有至少 1 GB 的儲存空間，用於從 AWS Panorama 設備傳輸日誌檔案。

**從裝置輸出日誌**

1. 在`managed_logs`資料夾內準備具有`panorama`資料夾的 USB 隨身碟。

   ```
   /
    └── panorama
        └── managed_logs
   ```

1. 將 USB 隨身碟連接至裝置。

1. 關閉 AWS Panorama 設備的[電源](appliance-buttons.md#appliance-buttons-reset)。

1. 開啟 AWS Panorama 設備的電源。

1. 裝置會將日誌複製到裝置。進行此作業時，狀態 LED [會閃爍藍色](appliance-buttons.md)。

1. 然後，您可以在 `managed_logs`目錄中找到格式為 的日誌檔案 `panorama_device_log_v1_dd_hh_mm.img`

您無法自行解密日誌映像。與客戶支援、AWS Panorama 的技術客戶經理或解決方案架構師合作，以與服務團隊協調。