本頁面由 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. 安裝 Google Cloud CLI。安裝完成後，執行下列指令初始化 Google Cloud CLI：
  gcloud init
  如果您使用外部識別資訊提供者 (IdP)，請先使用聯合身分登入 gcloud CLI。
  
  注意：如果您先前已安裝 gcloud CLI，請執行 gcloud components update，確認您使用的是最新版本。
2. Set a default region and zone.
REST

如要在本機開發環境中使用本頁的 REST API 範例，請使用您提供給 gcloud CLI 的憑證。
詳情請參閱 Google Cloud 驗證說明文件中的「Authenticate for using REST」。

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

您可以透過設定專案層級或執行個體層級中繼資料，來控制執行個體是否將序列埠輸出傳送至 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 中建立排除篩選器，以從記錄檔探索器中移除特定序列埠項目。舉例來說，如果專案層級的中繼資料項目設為 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 的功能。