# 테넌트 격리를 사용하여 Lambda 함수 모니터링
<a name="tenant-isolation-monitor"></a>

Amazon CloudWatch, AWS X-Ray를 사용하고, [텔레메트리 API](telemetry-api.md)를 사용하여 확장에 대한 실시간 텔레메트리 데이터에 액세스하여 테넌트 격리 Lambda 함수를 모니터링할 수 있습니다.

## 테넌트 격리 모드의 로깅 이해
<a name="tenant-isolation-logging"></a>

테넌트 격리를 사용하는 함수의 경우 [JSON 로깅이 활성화](monitoring-cloudwatchlogs-logformat.md)된 상태에서 Lambda의 [함수 로그](monitoring-logs.md)에 테넌트 식별자가 자동으로 포함되므로 테넌트별 문제를 더욱 쉽게 모니터링하고 디버깅할 수 있습니다. Lambda는 각 실행 환경에 대해 별도의 [CloudWatch 로그 스트림](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html)을 생성합니다. CloudWatch Logs Insights를 사용하여 테넌트 식별자를 기준으로 필터링함으로써 특정 테넌트에 속하는 로그 스트림을 찾을 수 있습니다.

```
fields @logStream, @message
| filter tenantId=='BlueTenant' or record.tenantId=='BlueTenant'
| stats count() as logCount by @logStream
| sort @timestamp desc
```

이 파라미터를 사용하여 모든 로그 스트림에서 테넌트별 로그를 검색할 수도 있습니다.

```
fields @message
| filter tenantId=='BlueTenant' or record.tenantId=='BlueTenant'
| limit 1000
```

`tenantId` 속성은 아래와 같이 함수 코드에 인쇄하는 플랫폼 이벤트(예: `platform.start` 및 `platform.report`) 및 사용자 지정 로그에 포함됩니다.

```
{
    "time": "2025-10-13T19:48:06.990Z",
    "type": "platform.start",
    "record": {
        "requestId": "a0f40320-b43c-44b3-91bf-d5b5240a1bed",
        "functionArn": "arn:aws:lambda:us-east-1:xxxxxx:function:multitenant-function-1",
        "version": "$LATEST",
        "tenantId": "BlueTenant""
    }
}
{
    "timestamp": "2025-10-13T19:48:06.992Z",
    "level": "INFO",
    "requestId": "a0f40320-b43c-44b3-91bf-d5b5240a1bed",
    "tenantId": "BlueTenant"",
    "message": "custom log line1"
}
{
    "timestamp": "2025-10-13T19:48:07.022Z",
    "level": "WARN",
    "requestId": "a0f40320-b43c-44b3-91bf-d5b5240a1bed",
    "tenantId": "BlueTenant"",
    "message": "custom log line2"
}
```