本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# **eb logs**
## Description
**eb logs** 命令有三種不同的用途：啟用或停用 CloudWatch Logs 的日誌串流、擷取執行個體日誌或 CloudWatch Logs 日誌，以及請求對您環境進行 AI 支援的分析。使用 `--cloudwatch-logs` (`-cw`) 選項，該命令會啟用或停用日誌串流。使用 `--analyze`(`-ai`) 選項，命令會請求對您環境的日誌、事件和執行個體運作狀態進行 AI 技術的分析。如果沒有這些選項，它會擷取日誌。
當擷取日誌、指定 `--all`、`--zip` 或 `--stream` 選項以擷取完整的日誌。如果您不指定這些的任何選項，Elastic Beanstalk 會擷取結尾日誌。
命令會處理指定或預設環境的日誌。相關日誌依容器類型而異。如果根目錄包含 `platform.yaml` 檔案，其中指定自訂的平台，則此命令也會處理建置器環境的日誌。
如需詳細資訊，請參閱[搭配 Amazon CloudWatch Logs 使用 Elastic Beanstalk](AWSHowTo.cloudwatchlogs.md)。如需 AI 驅動分析的詳細資訊，請參閱 [AI 驅動的環境分析](health-ai-analysis.md)。
## 語法
啟用或停用將日誌串流到 CloudWatch Logs：
```
eb logs --cloudwatch-logs [enable | disable] [--cloudwatch-log-source instance | environment-health | all] [{{environment-name}}]
```
若要擷取執行個體日誌：
```
eb logs [-all | --zip | --stream] [--cloudwatch-log-source instance] [--instance {{instance-id}}] [--log-group {{log-group}}] [{{environment-name}}]
```
若要擷取環境運作狀態日誌：
```
eb logs [-all | --zip | --stream] --cloudwatch-log-source environment-health [{{environment-name}}]
```
若要請求 AI 驅動的分析：
```
eb logs --analyze [{{environment-name}}]
```
## 選項
****
| 名稱 | 描述 |
| --- | --- |
| `-cw [enable \| disable]`
或
`--cloudwatch-logs [enable \| disable]` | 啟用或停用將日誌串流到 CloudWatch Logs。若未提供引數，則會啟用日誌串流。如果未另外指定 `--cloudwatch-log-source` (`-cls`) 選項，便會啟用或停用執行個體日誌串流。 |
| `-cls instance \| environment-health \| all`
或
`--cloudwatch-log-source instance \| environment-health \| all` | 指定使用 CloudWatch Logs 時的日誌來源。使用啟用或停用形式的命令，這些是可為其啟用或停用 CloudWatch Logs 串流的日誌。使用擷取形式的命令，這些是從 CloudWatch Logs 擷取的日誌。
有效值：[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/elasticbeanstalk/latest/dg/eb3-logs.html)
值含意：[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/elasticbeanstalk/latest/dg/eb3-logs.html) |
| `-a`
或
`--all` | 擷取完整日誌，並將其儲存至 `.elasticbeanstalk/logs` 目錄。 |
| `-z`
或
`--zip` | 擷取完整日誌，將其壓縮為 `.zip` 檔案並儲存至 `.elasticbeanstalk/logs` 目錄。 |
| `--stream` | 串流 (持續輸出) 完整的日誌。使用此選項時，命令會持續執行直到中斷 (按下 **Ctrl\+C**)。 |
| `-i {{instance-id}}`
或
`--instance {{instance-id}}` | 僅擷取指定執行個體的日誌。 |
| `-g {{log-group}}`
或
`--log-group {{log-group}}` | 指定擷取日誌之來源的 CloudWatch Logs 日誌群組。此選項只在啟用執行個體日誌串流到 CloudWatch Logs 時有效。
如果啟用執行個體日誌串流，而且您未指定 `--log-group` 選項，預設的日誌群組是以下其中一項：[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/elasticbeanstalk/latest/dg/eb3-logs.html)
如需有關對應到每個日誌檔的日誌群組的詳細資訊，請參閱 [Elastic Beanstalk 如何設定 CloudWatch Logs](AWSHowTo.cloudwatchlogs.md#AWSHowTo.cloudwatchlogs.loggroups)。 |
| `-ai`
或
`--analyze` | 請求對環境日誌、事件和執行個體運作狀態進行 AI 支援的分析。分析使用 Amazon Bedrock 來識別根本原因，並建議環境運作狀態問題的解決方案。命令會傳送請求、等待分析完成，然後顯示結果。
此選項與 `--instance`、`--all`、`--log-group`、 `--zip`或 不相容`--cloudwatch-logs`。
如需先決條件和必要許可，請參閱 [AI 驅動的環境分析](health-ai-analysis.md)。 |
| [常用選項](eb3-cmd-options.md) | |
## Output
在預設情況下，會直接在終端機顯示日誌。使用分頁程式以顯示輸出。按下 **Q** 或 **q** 以退出。
使用 `--stream`，在終端機顯示現有的日誌，並持續執行。按下 **Ctrl\+C** 離開。
使用 `--all` 和 `--zip`，將日誌儲存到本機檔案，並顯示檔案的位置。
透過 `--analyze`， 會在分析完成後，直接在終端機中顯示 AI 產生的分析。
## 範例
以下範例啟用將執行個體日誌串流到 CloudWatch Logs。
```
$ eb logs -cw enable
Enabling instance log streaming to CloudWatch for your environment
After the environment is updated you can view your logs by following the link:
https://console.aws.amazon.com/cloudwatch/home?region=us-east-1#logs:prefix=/aws/elasticbeanstalk/{{environment-name}}/
Printing Status:
2018-07-11 21:05:20 INFO: Environment update is starting.
2018-07-11 21:05:27 INFO: Updating environment {{environment-name}}'s configuration settings.
2018-07-11 21:06:45 INFO: Successfully deployed new configuration to environment.
```
以下範例擷取執行個體日誌到 `.zip` 檔案。
```
$ eb logs --zip
Retrieving logs...
Logs were saved to /home/workspace/environment/.elasticbeanstalk/logs/150622_173444.zip
```
下列範例會請求環境的 AI 驅動分析。
```
$ eb logs --analyze
Analyzing environment...
No critical issues detected. Environment appears healthy.
---
Note: This analysis was generated by AI.
```