

サポート終了通知: 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` — 無線通信 (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>

`/opt/aws/panorama/logs` にログファイルを書き込むための Python ロガーを設定します。アプライアンスはこの場所から 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) — ロガー設定**  

```
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 無線通信経由 (OTA) 更新エージェントのログ。
+ `/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 ドライブ** — AWS Panorama アプライアンスからログファイルを転送するための、少なくとも 1 GB のストレージを備えた FAT32 形式の USB フラッシュメモリドライブ。

**デバイスからログを出力する**

1. `panorama` フォルダー内にある `managed_logs` フォルダーが入った 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 のテクニカルアカウントマネージャー、またはソリューションアーキテクトと協力してサービスチームとの調整を行ってください。