Firebase 데이터를 Cloud Logging으로 내보내기

다양한 Firebase 제품의 데이터를 Cloud Logging으로 내보내면 프로젝트 및 앱의 로그를 보고, 검색하고, 필터링할 수 있습니다.

다음 제품은 Cloud Logging으로의 데이터 내보내기를 지원합니다.

  • Firebase Hosting: 내보내기를 설정하면 Firebase에서 Firebase Hosting 사이트의 웹 요청 로그를 Cloud Logging으로 내보냅니다.

  • Cloud Functions for Firebase: 내보내기를 설정할 필요가 없습니다. Firebase가 함수 로그를 Cloud Logging으로 자동 내보냅니다.

이 페이지는 다음 작업을 하는 데 도움이 됩니다.

Cloud Logging으로 내보내기 이해

Cloud Logging은 Google Cloud Observability Suite에서 제공합니다.

로그를 Cloud Logging으로 내보낼 때 Google Cloud 콘솔의 Logs Viewer 인터페이스를 사용하여 이러한 로그를 보고, 검색하고, 필터링할 수 있습니다. 다른 Google Cloud 도구를 사용하여 로그를 쿼리하고, 로그 기반 측정항목을 만들고 사용하고, 로그 데이터를 저장할 수 있습니다. 이러한 도구에 대한 자세한 내용은 Cloud Logging 문서를 참고하세요.

Cloud Functions for Firebase의 경우 Firebase Console의 함수 대시보드에서 로그를 볼 수도 있습니다.

Firebase Hosting

Hosting과 함께 Cloud Logging을 사용하면 사용자가 사이트를 방문한 위치와 시기, 사이트의 응답 상태, 최종 사용자 요청의 지연 시간 등을 추적할 수 있습니다.

프로젝트에 Hosting 사이트가 여러 개 있는 경우 로그를 내보낼 Hosting 사이트를 선택할 수 있습니다. 그런 다음 Hosting 사이트 및 도메인을 기준으로 로그 데이터를 필터링하고 볼 수 있습니다. 로그를 내보낼 특정 Hosting 사이트를 선택하면 프로젝트에서 처리되는 데이터 양을 제어할 수 있습니다. Hosting 사이트의 로그 데이터 사용량을 확인하려면 Firebase Console의 Cloud Logging 통합 카드를 참고하세요.

Cloud Logging 및 Firebase Hosting 통합 자세히 알아보기

Cloud Logging으로 내보내기 설정

Cloud Logging으로 내보내기를 설정하고 Cloud Logging에 연결할 Firebase Hosting 사이트를 선택하는 방법은 다음과 같습니다.

  1. Firebase Console에 로그인한 후 프로젝트를 선택합니다.

  2. 을 클릭한 후 프로젝트 설정을 선택합니다.

  3. 통합 탭을 선택합니다.

  4. Cloud Logging 통합 카드에서 연결을 클릭합니다.

  5. 화면에 표시된 안내에 따라 Cloud Logging을 설정하고 로그를 내보낼 Hosting 사이트를 선택합니다.

    활성 Hosting 사이트가 하나 이상 있는 경우 연결 워크플로에 각 Hosting 사이트의 로그에 대한 예상 데이터 사용량 수준이 표시됩니다. 이 값은 지난 30일 사용량을 통해 측정한 수치입니다.

연결하면 Hosting 사이트에 대한 새 요청에 대한 로그가 일반적으로 요청 후 30분 안에 표시됩니다.

  • Firebase Console의 Cloud Logging 통합 카드에서 Hosting 사이트의 로그 데이터 사용량 수준을 확인할 수 있습니다.

  • Google Cloud 콘솔의 Logs Viewer 인터페이스(log_bytes 측정항목)에서 사이트별 데이터 사용량 수준을 확인할 수 있습니다. 프로젝트에서 다른 제품에 Cloud Logging을 사용하는 경우 Logs Viewer 인터페이스에서 총 사용량을 확인할 수도 있습니다.

Firebase 프로젝트를 Cloud Logging에서 연결 해제하면 Cloud Logging으로의 모든 Firebase Hosting 내보내기가 중지됩니다. 이 작업은 Cloud Functions for Firebase의 로그 내보내기에 영향을 미치지 않습니다.

다음 사항에 유의하세요.

  • Cloud Functions for Firebase를 사용하는 경우 함수 로그가 계속 Cloud Logging으로 내보내집니다.

  • Cloud Logging에서 Hosting 로그의 데이터 세트를 삭제하지 않으면 30일 동안 유지된 후 Cloud Logging에서 자동으로 삭제됩니다.

  • Hosting 로그의 Cloud Logging 데이터가 다른 서비스(예: BigQuery)에 저장되어 있다면 이러한 데이터에 다른 데이터 지속성 약관이 적용될 수 있습니다.

Firebase 프로젝트(특히 Firebase Hosting 사이트)를 Cloud Logging에서 연결 해제하는 방법은 다음과 같습니다.

  1. Firebase Console에 로그인한 후 프로젝트를 선택합니다.

  2. 을 클릭한 후 프로젝트 설정을 선택합니다.

  3. 통합 탭을 선택합니다.

  4. Cloud Logging 통합 카드에서 관리를 클릭합니다.

  5. 페이지 하단에서 Cloud Logging으로 내보내기 중지를 클릭합니다.

  6. 연결을 해제하고 모든 내보내기를 중지할지 확인합니다.

Cloud Logging 할당량, 가격 책정, 보관 기간

Cloud Logging에서는 프로젝트당 매월 무료 사용량을 제공합니다. 사용량은 Cloud Logging을 사용하는 모든 Google 또는 Firebase 제품에서 사용할 수 있습니다. 프로젝트를 사용한 만큼만 지불하는 Blaze 요금제로 업그레이드하면 추가 유료 사용량과 기능을 이용할 수 있습니다. Cloud Logging 가격 책정 자세히 알아보기

Cloud Logging 및 결제를 모니터링하고 관리할 수 있습니다.

30일이 지나면 로그가 자동으로 삭제되며 커스텀 보관 기간을 설정할 수 있는 옵션도 제공됩니다.

특정 요청의 로그 항목이 지연되거나 드물게 삭제될 수 있습니다. 로그를 사용하여 요청을 이해할 수 있지만 프로젝트 사용량 및 청구에 표시되는 실제 사용량은 반영되지 않을 수 있습니다.