本頁面由 Cloud Translation API 翻譯而成。

查看序列埠輸出內容
透過集合功能整理內容你可以依據偏好儲存及分類內容。

虛擬機器 (VM) 執行個體有四個虛擬序列埠。執行個體的作業系統、BIOS 及其他系統層級實體通常會將輸出內容寫入序列埠，因此序列埠輸出內容可在排解當機、啟動失敗、開機或關機問題時派上用場。

本頁面說明查看序列埠輸出內容的方法，包括使用 Cloud Logging 來保留序列埠輸出內容，即使在執行個體已停止或遭刪除後也可繼續保留。如果您需要在執行個體運作時傳送指令至序列埠，請參閱「與序列主控台互動」一文。

只有在 VM 執行個體運作時，才能透過 Google Cloud 控制台、gcloud CLI 和 REST 存取序列埠輸出，記錄只限於每個通訊埠最近 1 MB 的輸出內容。

如果您啟用序列埠輸出記錄功能，Cloud Logging 每月提供前 50 吉位元組 (GiB) 的免費記錄，並保留 30 天的記錄。

事前準備

如要在 Cloud Logging 中記錄序列埠輸出內容，請先熟悉 Cloud Logging。
如果尚未設定，請先設定驗證機制。驗證是指驗證身分，以便存取 Google Cloud 服務和 API 的程序。如要在本機開發環境中執行程式碼或範例，您可以選取下列任一選項，向 Compute Engine 進行驗證：

Select the tab for how you plan to use the samples on this page:
Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
1. After installing the Google Cloud CLI, initialize it by running the following command:
  gcloud init
  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
  
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.
REST

To use the REST API samples on this page in a local development environment, you use the credentials you provide to the gcloud CLI.
For more information, see Authenticate for using REST in the Google Cloud authentication documentation.

啟用及停用序列埠輸出記錄

您可以透過設定專案層級或執行個體層級中繼資料，來控制執行個體是否將序列埠輸出傳送至 Cloud Logging。您也可以透過設定組織政策來停用機構中所有使用者的這項功能。

設定專案和執行個體中繼資料

根據預設，系統會停用將序列埠輸出記錄寫入至 Cloud Logging 的功能。如果您的機構未限制將序列埠輸出記錄寫入至 Cloud Logging，可以將 serial-port-logging-enable 中繼資料項目設為 true 或 false，為專案和個別 VM 執行個體啟用或停用這項功能。

如果您設定全專案中繼資料項目，專案中的所有 VM 執行個體都會隱含繼承該設定。如果您設定執行個體中繼資料項目，則無論專案設定為何，系統都只會針對該 VM 啟用中繼資料項目。

您可以使用 Google Cloud 控制台、gcloud CLI 或 Compute Engine API 設定中繼資料項目。詳情請參閱「設定自訂中繼資料」。

舉例來說，下列 gcloud CLI 指令可為專案啟用將序列埠輸出記錄寫入至 Cloud Logging 的功能：

gcloud compute project-info add-metadata \
    --metadata serial-port-logging-enable=true

同樣地，下列 gcloud CLI 指令會為特定例項啟用將序列埠輸出記錄寫入至 Cloud Logging 的功能：

gcloud compute instances add-metadata INSTANCE_NAME \
    --metadata serial-port-logging-enable=true

如要停用將序列埠輸出記錄寫入至 Cloud Logging 的功能，請將 serial-port-logging-enable 設為 false：

gcloud compute instances add-metadata INSTANCE_NAME \
    --metadata serial-port-logging-enable=false

排除篩選器

您可以在 Cloud Logging 中建立排除篩選器，以從 Logs Explorer 中移除特定序列埠項目。舉例來說，如果專案層級的中繼資料項目設為 serial-port-logging-enable=true，您可以使用進階篩選器，針對特定 VM 執行個體停用序列埠輸出記錄功能：

logName = "projects/PROJECT_ID/logs/serialconsole.googleapis.com%2Fserial_port_1_output"
resource.type = "gce_instance"
resource.labels.instance_id != "INSTANCE_1_ID"
resource.labels.instance_id != "INSTANCE_2_ID"

設定組織政策

您可以透過設定組織政策來為整個機構停用將序列埠輸出記錄寫入至 Cloud Logging 的功能，藉此限制 Google Cloud 資源的某些設定。具體而言，請設定下列布林限制：constraints/compute.disableSerialPortLogging。詳情請參閱「建立及管理機構政策」。

將 constraints/compute.disableSerialPortLogging 設為 true 來停用序列埠記錄功能的效力不溯及既往。如果現有 VM 執行個體含有可將序列埠記錄寫入至 Cloud Logging 的中繼資料項目，這些執行個體會繼續將記錄寫入 Cloud Logging，除非您重設這些執行個體的中繼資料。

將此機構限制設為 true 後，您就無法為機構內的任何執行個體，將執行個體或專案中繼資料設定為啟用將序列埠輸出記錄寫入至 Cloud Logging 的功能。