대시보드 구성

대시보드는 시작될 때 구성됩니다. 구성에는 프런트 엔드 및 OpenTelemetry 프로토콜(OTLP) 주소, 리소스 서비스 엔드포인트, 인증, 원격 분석 제한 등이 포함됩니다.

.NET .NET Aspire 앱 호스트 프로젝트로 대시보드가 시작되면 앱의 리소스 및 원격 분석을 표시하도록 자동으로 구성됩니다. 구성은 독립 실행형 모드대시보드를 시작할 때 제공됩니다.

구성을 제공하는 방법에는 여러 가지가 있습니다.

• 명령줄 인수입니다.
• 환경 변수. : 구분 기호는 환경 변수 이름에서 이중 밑줄(__)로 바꿔야 합니다.
• 선택적 JSON 구성 파일입니다. DOTNET_DASHBOARD_CONFIG_FILE_PATH 설정을 사용하여 JSON 구성 파일을 지정할 수 있습니다.

Docker 컨테이너에서 시작할 때 대시보드를 구성하는 방법을 보여주는 다음 예제를 살펴보겠습니다.

docker run --rm -it -p 18888:18888 -p 4317:18889 -d --name aspire-dashboard \
    -e DASHBOARD__TELEMETRYLIMITS__MAXLOGCOUNT='1000' \
    -e DASHBOARD__TELEMETRYLIMITS__MAXTRACECOUNT='1000' \
    -e DASHBOARD__TELEMETRYLIMITS__MAXMETRICSCOUNT='1000' \
    mcr.microsoft.com/dotnet/aspire-dashboard:9.0

docker run --rm -it -p 18888:18888 -p 4317:18889 -d --name aspire-dashboard `
    -e DASHBOARD__TELEMETRYLIMITS__MAXLOGCOUNT='1000' `
    -e DASHBOARD__TELEMETRYLIMITS__MAXTRACECOUNT='1000' `
    -e DASHBOARD__TELEMETRYLIMITS__MAXMETRICSCOUNT='1000' `
    mcr.microsoft.com/dotnet/aspire-dashboard:9.0

또는 DOTNET_DASHBOARD_CONFIG_FILE_PATH사용하여 지정된 JSON 구성 파일을 사용하여 이러한 동일한 값을 구성할 수 있습니다.

{
  "Dashboard": {
    "TelemetryLimits": {
      "MaxLogCount": 1000,
      "MaxTraceCount": 1000,
      "MaxMetricsCount": 1000
    }
  }
}

일반 구성

프런트 엔드 인증

대시보드 프런트 엔드 엔드포인트 인증은 Dashboard:Frontend:AuthMode구성됩니다. 프런트 엔드는 OIDC(OpenID Connect) 또는 브라우저 토큰 인증을 사용하여 보호될 수 있습니다.

브라우저 토큰 인증은 토큰을 요청하는 프런트 엔드에서 작동합니다. 토큰은 UI에 입력하거나 로그인 페이지에 쿼리 문자열 값으로 제공할 수 있습니다. 예를 들어 https://localhost:1234/login?t=TheToken. 토큰이 성공적으로 인증되면 인증 cookie 브라우저에 유지되고 브라우저가 앱으로 리디렉션됩니다.

OTLP 인증

OTLP 엔드포인트 인증은 Dashboard:Otlp:AuthMode구성됩니다. OTLP 엔드포인트는 API 키 또는 client 인증서 인증으로 보호될 수 있습니다.

API 키 인증은 각 OTLP 요청에 유효한 x-otlp-api-key 헤더 값이 있어야 합니다. 기본 키 또는 보조 키와 일치해야 합니다.

OTLP CORS

브라우저 앱이 대시보드에 원격 분석을 보낼 수 있도록 CORS(원본 간 리소스 공유)를 구성할 수 있습니다.

기본적으로 브라우저 앱은 도메인 간 API 호출을 할 수 없습니다. 대시보드와 브라우저 앱은 항상 서로 다른 도메인에 있기 때문에 이는 대시보드에 원격 분석을 보내는 데 영향을 줍니다. CORS를 구성하려면 Dashboard:Otlp:Cors 섹션을 사용하고 허용된 원본 및 헤더를 지정합니다.

{
  "Dashboard": {
    "Otlp": {
      "Cors": {
        "AllowedOrigins": "http://localhost:5000,https://localhost:5001"
      }
    }
  }
}

다음 구성 옵션을 고려합니다.

리소스

대시보드는 리소스 서비스에 연결하여 리소스 정보를 로드하고 표시합니다. client 서비스에 연결하는 방법에 대한 대시보드에 구성됩니다.

리소스 서비스 client 인증은 Dashboard:ResourceServiceClient:AuthMode구성됩니다. API 키 또는 client 인증서 인증을 지원하도록 client 구성할 수 있습니다.

원격 분석 제한

원격 분석은 메모리에 저장됩니다. 과도한 메모리 사용을 방지하기 위해 대시보드에는 저장된 원격 분석의 수와 크기에 제한이 있습니다. 개수 제한에 도달하면 새 원격 분석이 추가되고 가장 오래된 원격 분석이 제거됩니다. 크기 제한에 도달하면 데이터가 제한으로 잘립니다.

원격 분석 제한은 원격 분석 유형에 따라 서로 다른 범위를 갖습니다.

• MaxLogCount 및 MaxTraceCount 리소스 간에 공유됩니다. 예를 들어 5,000의 MaxLogCount 값은 모든 리소스에 대해 최대 5,000개의 총 로그 항목을 저장하도록 대시보드를 구성합니다.
• MaxMetricsCount 리소스당입니다. 예를 들어 10,000의 MaxMetricsCount 값은 리소스당 최대 10,000개의 메트릭 데이터 요소를 저장하도록 대시보드를 구성합니다.

다른

다음 단계