Lovable한국어 문서

Lovable에서 Azure Log Analytics 워크스페이스로 정기 데이터 내보내기를 설정합니다. 설정 스크립트가 소스마다 테이블과 데이터 수집 규칙을 만듭니다.

Lovable 로그를 Azure Log Analytics로 내보내기

Lovable에서 Azure Log Analytics 워크스페이스로 보내는 예약 데이터 내보내기를 설정합니다. 설정 스크립트가 소스마다 테이블과 데이터 수집 규칙(data collection rule)을 만듭니다.

Azure Log Analytics로 보내는 데이터 내보내기는 Log Analytics 워크스페이스의 테이블로 행을 보냅니다. 소스마다 별도의 테이블이 있으며, 설정 스크립트가 이 테이블을 데이터 수집 규칙과 함께 만듭니다. Lovable은 페더레이션 자격 증명을 통해 Microsoft Entra 테넌트의 앱 등록으로 로그인하므로 어느 쪽에도 시크릿이 저장되지 않습니다.

소스, 일정, 실행 동작은 데이터 내보내기를 참고하세요.

사전 요구 사항

  • Azure 퍼블릭 클라우드의 Log Analytics 워크스페이스. Azure Government, Azure China, 프라이빗 엔드포인트는 지원되지 않습니다.
  • Microsoft Entra ID에서 앱을 등록하고 페더레이션 자격 증명을 추가할 수 있는 권한
  • Log Analytics 워크스페이스의 리소스 그룹에서 테이블, 데이터 수집 규칙, 커스텀 역할, 역할 할당을 만들 수 있는 Azure 계정
  • bash 또는 zsh 셸에서 사용하며 Log Analytics 워크스페이스의 구독에 로그인된 Azure CLI
  • Enterprise 플랜의 Lovable 워크스페이스 admin 또는 owner 역할

내보내기 설정

소스마다 내보내기를 하나씩 설정합니다. 소스마다 테이블과 규칙이 따로 있으므로 각 내보내기의 설정 패널에 표시된 설정 스크립트를 실행하세요.

새 내보내기 시작

Data exports로 이동해 New data export를 클릭하고 Destination에서 Azure Log Analytics를 선택합니다. 이 단계에서 Source도 선택하세요. 설정 스크립트가 소스에 따라 달라지기 때문입니다.

앱 등록

이 Lovable 워크스페이스용 앱 하나를 등록합니다. Azure Portal에서 Microsoft Entra ID → App registrations → New registration을 엽니다. 앱의 Overview 페이지에서 Directory (tenant) ID를 Tenant ID에, Application (client) ID를 Client ID에 복사합니다. 설정 패널에 표시된 CLI 명령을 실행해도 됩니다.

이 Lovable 워크스페이스가 이미 Azure Blob Storage로 내보내고 있다면 그 앱과 페더레이션 자격 증명을 재사용할 수 있습니다.

Entra에서는 앱 하나에 발급자(issuer)와 주체(subject) 조합마다 페더레이션 자격 증명을 하나만 둘 수 있습니다. 따라서 두 번째 Lovable 워크스페이스에는 두 번째 앱이 필요합니다.

Lovable 신뢰 설정

앱에서 Certificates & secrets → Federated credentials → Add credential을 엽니다. 시나리오로 Other issuer를 선택하고 설정 패널의 Credential values를 입력합니다. 설정 패널에 표시된 CLI 명령을 실행해도 됩니다.

워크스페이스 리소스 ID 입력

Azure에서 Log Analytics 워크스페이스의 Properties 페이지를 열고 Resource ID를 복사합니다. 이 값을 Log Analytics workspace resource ID에 붙여 넣습니다. 형식은 /subscriptions/<subscription ID>/resourceGroups/<resource group>/providers/Microsoft.OperationalInsights/workspaces/<workspace name>입니다.

테이블 생성 및 접근 권한 부여

설정 패널에서 Azure CLI script를 복사해 실행합니다. 이 스크립트에는 입력값이 이미 들어 있어 그대로 붙여 넣으면 됩니다. 스크립트는 소스용 테이블과 데이터 수집 규칙을 만들거나 업데이트한 뒤, 앱이 Log Analytics 워크스페이스와 그 테이블, 그 규칙을 읽고 규칙을 통해 데이터를 보낼 수 있게 합니다.

스크립트는 언제든 다시 실행할 수 있습니다. 역할 할당이 적용되기까지 몇 분이 걸릴 수 있습니다.

연결 테스트

Test connection을 클릭합니다. Access check succeeded는 Azure 인증, 테이블과 규칙, 이에 대한 권한이 모두 확인을 통과했다는 뜻입니다. 테스트는 이벤트를 보내지 않습니다. 수집이 제대로 동작하는지는 첫 실행에서 확인됩니다.

내보내기 생성

Create export를 클릭합니다.

페더레이션 자격 증명과 권한의 기준은 설정 패널입니다. 역할을 직접 만들지 말고 설정 패널에 표시된 스크립트를 실행하세요.

Lovable이 접근할 수 있는 범위

Lovable이 로그인하는 앱은 Log Analytics 워크스페이스, 그리고 설정 스크립트가 이 앱용으로 만든 테이블과 데이터 수집 규칙을 읽을 수 있습니다. 또한 이 리소스에 대한 자신의 권한을 확인하고, 해당 규칙을 통해 데이터를 보낼 수 있습니다. Lovable은 테이블이나 규칙을 변경할 수 없습니다. 쓰기, 삭제, 역할 할당, 워크스페이스 키, 로그 쿼리 권한도 없습니다.

테이블과 열

각 소스에는 별도의 테이블이 있습니다.

소스테이블
감사 로그LovableAuditLogsV2_CL

Lovable은 각 소스 행을 동적(dynamic) Payload 열에 담아 보내며, 필드 이름과 JSON 타입은 소스에 나열된 것을 따릅니다. 각 테이블에는 다음 열이 있습니다.

열내용
TimeGenerated이벤트가 발생한 UTC 시각(소스의 timestamp)입니다.
EventTime이벤트가 발생한 UTC 시각(소스의 timestamp)입니다.
EventId행의 id입니다. 중복 제거에 사용합니다.
WorkspaceIdLovable 워크스페이스의 ID입니다.
ProjectId감사 로그에서는 비어 있습니다.
LovableExportId내보내기의 ID입니다.
LovableRunId행을 전달한 실행의 ID입니다.
Payload중첩된 값을 포함해 소스 행을 JSON 객체로 담습니다. 필드는 소스를 참고하세요. Azure 크기 제한이 적용됩니다.

Azure가 행을 처리한 뒤에 테이블에 행이 나타납니다. 설정 후 첫 전달은 몇 분이 걸릴 수 있습니다.

테이블은 Analytics 플랜과 Log Analytics 워크스페이스의 보존 기간을 사용합니다. 새로운 소스 필드는 테이블이나 데이터 수집 규칙을 업데이트하지 않아도 Payload 안에 나타납니다.

쿼리 및 중복 제거

전달은 최소 1회(at-least-once) 방식이므로 재시도된 실행이 같은 행을 다시 보낼 수 있습니다. 쿼리에서 EventId로 중복을 제거하세요.

LovableAuditLogsV2_CL
| summarize arg_max(TimeGenerated, *) by EventId

감사 로그의 Payload.details에는 JSON 텍스트가 들어 있습니다. 그 안의 프로퍼티를 쿼리하려면 먼저 파싱하세요.

LovableAuditLogsV2_CL
| extend Details = parse_json(tostring(Payload.details))
| project TimeGenerated, Action = tostring(Payload.action), Details

내보내기 변경 또는 제거

내보내기의 테넌트 ID, 클라이언트 ID, 워크스페이스 리소스 ID는 변경할 수 없습니다. 이를 바꾸려면 새 내보내기를 만드세요.

내보내기를 삭제해도 테이블, 데이터 수집 규칙, 데이터는 Azure에 그대로 남습니다. 이를 제거하려면 먼저 내보내기를 비활성화하거나 삭제한 다음 Azure에서 삭제하세요. Lovable은 사용자가 삭제한 테이블이나 규칙을 다시 만들 수 없습니다. 설정 스크립트를 다시 실행할 때까지 실행은 실패합니다.

Azure 크기 제한

Azure는 Logs Ingestion API 요청 하나의 크기를 1 MB로 제한하며, 여기에는 이벤트 페이로드와 Lovable이 각 행에 추가하는 메타데이터 열(EventId, WorkspaceId, LovableExportId, LovableRunId, 시간 열)이 포함됩니다. 이 요청 한도를 지키더라도 개별 필드가 온전히 보존된다는 보장은 없습니다. 자세한 내용은 Azure Monitor 서비스 한도를 참고하세요.

Azure는 요청을 수락하더라도 64 KB보다 긴 필드 값을 잘라낼 수 있습니다. Azure가 수락한 실행은 일부 값이 잘렸더라도 전달된 것으로 간주됩니다. Lovable은 모든 값을 온전히 보내며, 보낸 값을 다시 읽어 확인하지 않습니다.

문제 해결

일반적인 실행 문제는 문제 해결을 참고하세요.

On this page