OpseerOpseer
Docs
Dashboard

Firebase Functions

Opseer에서 Cloud Functions를 관리하기 위한 Google Cloud IAM 역할 설정 방법.

Last updated: 2026-05-09

Firebase Cloud Functions 관리에는 기본 Firebase 서비스 계정 외에 추가적인 Google Cloud IAM 역할이 필요합니다. 이 가이드에서 설정 과정을 안내합니다.

Cloud Functions를 설정하기 전에 Firebase가 프로젝트에 이미 연결되어 있어야 합니다. Firebase 연동 가이드를 참고하세요.

왜 추가 설정이 필요한가요?

Firebase Admin SDK에는 Cloud Functions 관리 기능이 포함되어 있지 않습니다. Opseer는 Google Cloud Functions API v2와 Cloud Logging API를 직접 사용하며, 서비스 계정에 명시적인 IAM 권한이 필요합니다.

1단계: Cloud Functions API 활성화

1

Google Cloud Console 열기

console.cloud.google.com에 접속하여 Firebase 프로젝트를 선택합니다.

2

APIs & Services 이동

왼쪽 사이드바에서 "APIs & Services" > "Enabled APIs & Services"를 클릭합니다.

3

Cloud Functions API 검색

"+ Enable APIs and Services"를 클릭하고 "Cloud Functions API"를 검색합니다.

4

활성화

"Enable"을 클릭합니다. 변경이 반영될 때까지 약 1분 정도 걸릴 수 있습니다.

Opseer에서 "API not enabled" 오류가 표시되면, 제공된 링크를 클릭하여 활성화 페이지로 바로 이동할 수 있습니다.

2단계: IAM 역할 추가

Firebase 서비스 계정에 Opseer의 모든 Cloud Functions 기능을 사용하기 위한 세 가지 IAM 역할이 필요합니다:

  • Cloud Functions Viewer — 함수 목록 및 상세 정보 조회
  • Logs Viewer — 함수 실행 로그 조회
  • Monitoring Viewer — 함수 메트릭 조회 (준비 중)

역할 추가 방법

1

IAM 페이지 열기

console.cloud.google.com/iam-admin/iam에 접속하여 프로젝트를 선택합니다.

2

서비스 계정 찾기

[email protected] 형식의 이메일이 있는 행을 찾습니다.

3

편집(연필) 아이콘 클릭

서비스 계정 행의 오른쪽에 있습니다.

4

"Add another role" 클릭

기존 역할을 수정하지 마세요. "Add another role" 버튼을 클릭합니다.

5

"Cloud Functions Viewer" 검색 및 추가

검색창에 "Cloud Functions Viewer"를 입력하고 선택합니다.

6

"Logs Viewer" 추가

"Add another role"을 다시 클릭하고 "Logs Viewer"를 검색합니다.

7

"Monitoring Viewer" 추가

"Add another role"을 다시 클릭하고 "Monitoring Viewer"를 검색합니다.

8

저장

"Save"를 클릭하여 변경 사항을 적용합니다. 반영까지 1~2분이 소요될 수 있습니다.

기존 역할 (예: "Firebase Admin SDK Administrator Service Agent")을 제거하지 마세요. 새 역할만 추가합니다.

3단계: Opseer에서 확인

1

Firebase > Functions 이동

프로젝트 사이드바에서 Firebase를 펼치고 Functions를 클릭합니다.

2

함수 목록 확인

IAM 역할이 올바르게 설정되었다면, 배포된 Cloud Functions가 상태, 런타임, 리전과 함께 목록에 표시됩니다.

3

함수 선택

함수를 클릭하면 상세 정보와 실행 로그를 터미널에서 확인할 수 있습니다.

사용 가능한 기능

  • 배포된 모든 Cloud Functions 조회 (이름, 상태, 런타임, 리전, 트리거 유형)
  • 함수 상세 정보 확인 (메모리, 타임아웃, 환경변수, HTTP URL)
  • 실시간 실행 로그 모니터링 (5초마다 자동 새로고침)
  • 로그 심각도별 필터링 (INFO, WARNING, ERROR, DEBUG)
  • 대시보드에서 직접 HTTP 함수 호출 (테스트 용도)
  • 함수 삭제 (Owner/Admin만 가능)

문제 해결

"Cloud Functions API is not enabled"

Google Cloud Console에서 Cloud Functions API를 활성화해야 합니다. 오류 메시지에 있는 버튼을 클릭하면 활성화 페이지로 바로 이동할 수 있습니다.

"IAM permission required"

서비스 계정에 필요한 IAM 역할이 없습니다. 위의 2단계를 따라 Cloud Functions Viewer, Logs Viewer, Monitoring Viewer 역할을 추가하세요.

"No log entries found"

함수가 최근에 호출되지 않았다는 의미입니다. 로그는 함수가 실행될 때만 생성됩니다. 함수를 호출한 후 다시 확인해 보세요.