직렬 포트 출력 보기

가상 머신(VM) 인스턴스에는 4개의 가상 직렬 포트가 있습니다. 인스턴스의 운영체제, BIOS, 기타 시스템 수준 항목은 보통 직렬 포트에 출력을 쓰므로 직렬 포트 출력은 장애, 부팅 실패, 시작 또는 종료 문제를 해결하는 데 유용합니다.

이 페이지에서는 인스턴스가 중지되거나 삭제된 후에도 Cloud Logging을 사용하여 직렬 포트 출력을 보존하는 방법을 포함하여 직렬 포트 출력을 보는 방법을 설명합니다. 인스턴스가 실행 중일 때 직렬 포트에 명령어를 전송해야 하는 경우 직렬 콘솔과 상호작용을 참조하세요.

직렬 포트 출력은 Google Cloud 콘솔, gcloud CLI, REST를 통해 액세스할 수 있지만 VM 인스턴스가 실행되는 동안에만 액세스할 수 있습니다. 로그는 포트당 최근 1MB 출력으로 제한됩니다.

직렬 포트 출력 로깅을 사용 설정하면 Cloud Logging에서 매월 첫 50기가바이트(GiB)의 로깅을 무료로 제공하고 30일 동안 로그를 유지합니다.

시작하기 전에

Cloud Logging에서 직렬 포트 출력을 로깅하려면 Cloud Logging에 익숙해야 합니다.
아직 인증을 설정하지 않았다면 설정합니다. 인증은 Google Cloud 서비스 및 API에 액세스하기 위해 ID를 확인하는 프로세스입니다. 로컬 개발 환경에서 코드 또는 샘플을 실행하려면 다음 옵션 중 하나를 선택하여 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. Install the Google Cloud CLI. After installation, initialize the Google Cloud CLI 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

로컬 개발 환경에서 이 페이지의 REST API 샘플을 사용하려면 gcloud CLI에 제공한 사용자 인증 정보를 사용합니다.
자세한 내용은 Google Cloud 인증 문서의 REST 사용을 위한 인증을 참조하세요.

직렬 포트 출력 로깅 사용 설정 및 사용 중지

프로젝트 또는 인스턴스 수준 메타데이터를 설정하여 인스턴스가 Cloud Logging에 직렬 포트 출력을 전송할지 여부를 제어할 수 있습니다. 또한 조직 정책을 설정하여 조직의 모든 사용자를 대상으로 이 기능을 사용 중지할 수도 있습니다.

프로젝트 및 인스턴스 메타데이터 설정

기본적으로 Cloud Logging에 대한 직렬 포트 출력 로깅이 중지되어 있습니다. Cloud Logging에 직렬 포트 출력 로깅 기능이 조직에서 제한되지 않으면 serial-port-logging-enable 메타데이터 항목을 true 또는 false로 설정하여 프로젝트와 개별 VM 인스턴스의 직렬 포트 출력 로깅을 사용 설정하거나 중지할 수 있습니다.

프로젝트 차원 메타데이터 항목을 설정하면 프로젝트의 모든 VM 인스턴스가 해당 설정을 암시적으로 상속합니다. 인스턴스 메타데이터 항목을 설정하면 프로젝트 설정과 관계없이 해당 VM에만 메타데이터 항목이 사용 설정됩니다.

Google Cloud Console, 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"

조직 정책 설정

Google Cloud 리소스의 특정 구성을 제한하는 조직 정책을 설정하여 전체 조직에 대해 Cloud Logging으로의 직렬 포트 출력 로깅을 사용 중지할 수 있습니다. 구체적으로 constraints/compute.disableSerialPortLogging과 같은 불리언 제약조건을 설정합니다. 자세한 내용은 조직 정책 만들기 및 관리를 참조하세요.

constraints/compute.disableSerialPortLogging을 true로 설정하여 직렬 포트 로깅을 사용 중지해도 소급 적용되지 않습니다. Cloud Logging에 직렬 포트 로깅을 사용 설정하는 메타데이터 항목이 있는 기존 VM 인스턴스의 경우 해당 인스턴스에 대해 메타데이터를 재설정하지 않는 한 Cloud Logging에 계속 로깅됩니다.

이러한 조직 제약조건을 true로 설정한 후에는 조직 내 어느 인스턴스에도 Cloud Logging에 대한 직렬 포트 출력 로깅을 사용 설정하도록 인스턴스 또는 프로젝트 메타데이터를 설정할 수 없습니다.