.NET .NET Aspire 대시보드 살펴보기

향후 섹션에서는 .NET.NET Aspire 프로젝트를 만들고 다음 작업을 수행하는 방법을 알아봅니다.

이 문서에 소개된 스크린샷은 어두운 테마를 보여줍니다. 테마 선택에 대한 자세한 내용은 테마 선택참조하세요.

대시보드 인증

.NET .NET Aspire 앱 호스트를 실행하면 오케스트레이터가 앱의 모든 종속 리소스를 시작한 다음 대시보드에 대한 브라우저 창을 엽니다. .NET .NET Aspire 대시보드는 환경 변수 및 기타 중요한 정보를 표시하기 때문에 사용자에 대한 토큰 기반 인증이 필요합니다.

Visual Studio 또는 Visual Studio Code(C# Dev Kit 확장)에서 대시보드가 시작되면 브라우저가 자동으로 로그인되고 대시보드가 직접 열립니다. 이는 일반적인 개발자 F5 환경이며 인증 로그인 흐름은 .NET.NET Aspire 도구에 의해 자동화됩니다.

그러나 명령줄에서 앱 호스트를 시작하면 로그인 페이지가 표시됩니다. 콘솔 창에는 브라우저에서 대시보드를 열기 위해 선택할 수 있는 URL이 표시됩니다.

URL에는 대시보드에 로그인하는 데 사용되는 토큰 쿼리 문자열( 이름 부분에 매핑된 토큰 값 포함)이 포함됩니다. 콘솔에서 지원하는 경우 Ctrl 키를 누른 다음 링크를 선택하여 브라우저에서 대시보드를 열 수 있습니다. 이 메서드는 콘솔에서 토큰을 복사하여 로그인 페이지에 붙여넣는 것보다 쉽습니다. 앞에서 설명한 방법 중 하나를 사용하지 않고 대시보드 로그인 페이지에서 끝나는 경우 언제든지 콘솔로 돌아가 토큰을 복사할 수 있습니다.

다음 스크린샷과 같이 로그인 페이지에서 토큰을 수락하고 토큰을 가져오는 방법에 대한 유용한 지침을 제공합니다.

토큰을 가져오는 방법에 대한 지침이 포함된 대시보드 로그인 페이지를

콘솔에서 토큰을 복사하여 로그인 페이지에 붙여넣은 후 로그인 단추를 선택합니다.

텍스트 상자에 붙여넣은 토큰이 있는 대시보드 로그인 페이지를

대시보드는 3일 동안 유효한 상태로 유지되는 브라우저 영구 cookie토큰을 유지합니다. 영구 쿠키는 만료 날짜를 가지며 브라우저를 닫은 후에도 유효하게 유지됩니다. 즉, 사용자가 브라우저를 닫고 다시 여는 경우 다시 로그인할 필요가 없습니다. 자세한 내용은 대시보드 설명서를 실행하기 위한 보안 고려 사항을 참조하세요.

리소스 페이지

리소스 페이지는 .NET.NET Aspire 대시보드의 기본 홈페이지입니다. 이 페이지에는 .NET 솔루션에 포함된 모든 .NET Aspire 프로젝트, 컨테이너 및 실행 파일이 나열됩니다. 예를 들어 시작 애플리케이션에는 다음 두 개의 프로젝트가 포함됩니다.

• apiservice: 최소 API를 사용하여 빌드된 백 엔드 API 프로젝트입니다.
• webfrontend: Blazor사용하여 빌드된 프런트 엔드 UI 프로젝트입니다.

또한 대시보드는 각 리소스에 대한 필수 세부 정보를 제공합니다.

• 형식: 리소스가 프로젝트, 컨테이너 또는 실행 파일인지 여부를 표시합니다.
• 이름: 리소스의 이름입니다.
• 상태: 리소스가 현재 실행 중인지 여부를 표시합니다.
  • 오류: 상태 열 내에서 오류 수는 배지로 표시됩니다. 오류를 보고하는 리소스를 빠르게 이해하는 것이 유용합니다. 배지를 선택하면 오류 수준에서 필터를 사용하여 해당 리소스에 대한 의미 체계 로그 이동합니다.
• 시작 시간: 리소스가 실행되기 시작한 시기입니다.
• 원본: 디바이스에서 리소스의 위치입니다.
• 엔드포인트: 실행 중인 리소스에 직접 연결할 하나 이상의 URL입니다.
• 로그: 리소스 로그 페이지에 대한 링크입니다.
• 작업: 리소스에서 수행할 수 있는 작업 집합입니다.
  • 중지/시작: 현재 상태따라 리소스를 중지(또는 시작)합니다.
  • 콘솔 로그: 리소스의 콘솔 로그로 이동합니다.
  • 줄임표: 추가 리소스 관련 작업이 있는 하위 메뉴:
    • 세부 정보 보기: 리소스 세부 정보를 봅니다.
    • 콘솔 로그: 리소스의 콘솔 로그로 이동합니다.
    • 구조적 로그: 리소스의 구조화된 로그로 이동합니다.
    • 추적: 리소스의 추적으로 이동합니다.
    • 메트릭: 리소스의 메트릭으로 이동합니다.
    • 다시 시작: 중지한 다음 리소스를 시작합니다.

리소스 페이지의 다음 스크린샷을 고려합니다.

리소스 작업

각 리소스에는 리소스의 현재 상태에 따라 조건부로 사용하도록 설정된 사용 가능한 작업 집합이 있습니다. 예를 들어 리소스가 실행 중이면 중지 작업이 활성화됩니다. 리소스가 중지되면 시작 작업이 활성화됩니다. 마찬가지로 일부 작업은 사용할 수 없는 경우 비활성화됩니다. 예를 들어 일부 리소스에는 구조화된 로그가 없습니다. 이러한 상황에서는 구조적 로그 작업을 사용할 수 없습니다.

리소스 중지 또는 시작

.NET .NET Aspire 대시보드를 사용하면 작업 열에서 중지 또는 시작 단추를 선택하여 리소스를 중지하거나 시작할 수 있습니다. 중지 단추가 선택된 리소스 페이지의 다음 스크린샷을 고려합니다.

중지를 선택하면 리소스 실행이 중지되고 State 열이 업데이트되어 변경 내용이 반영됩니다.

그런 다음 시작 단추를 사용하도록 설정하여 리소스를 다시 시작할 수 있습니다. 또한 대시보드에는 작업 결과에 대한 알림 메시지가 표시됩니다.

리소스가 실행되지 않는 상태이면 시작 단추가 활성화됩니다. 시작 선택하면 리소스가 시작되고 State 열이 업데이트되어 변경 내용이 반영됩니다. 그런 다음 중지 단추를 사용하도록 설정하여 리소스를 다시 중지할 수 있습니다. 대시보드는 작업 결과에 대한 알림 메시지를 표시합니다.

리소스 하위 메뉴 작업

작업 열에서 가로 줄임표 아이콘을 선택하면 추가 리소스별 작업이 있는 하위 메뉴가 열립니다. 기본 제공 리소스 하위 메뉴 작업 외에도 사용자 지정 명령을 정의하여 사용자 지정 리소스 작업을 정의할 수도 있습니다. 자세한 내용은 사용자 지정 리소스 명령을 참조하세요. 기본 제공 리소스 하위 메뉴 작업의 경우 다음 스크린샷을 고려하세요.

대시보드 리소스 하위 메뉴 작업을

다음 하위 메뉴 작업을 사용할 수 있습니다.

• 세부 정보 보기: 리소스 세부 정보를 봅니다.
• 콘솔 로그: 리소스의 콘솔 로그로 이동합니다.
• 구조적 로그: 리소스의 구조화된 로그로 이동합니다.
• 추적: 리소스의 추적으로 이동합니다.
• 메트릭: 리소스의 메트릭으로 이동합니다.
• 다시 시작: 중지한 다음 리소스를 시작합니다.

텍스트 시각화 도우미에서 복사 또는 열기

특정 열의 텍스트 시각화 도우미 보려면 마우스를 가리키면 세로 줄임표 아이콘이 표시됩니다. 아이콘을 선택하여 사용 가능한 옵션을 표시합니다.

• 클립보드 복사
• 텍스트 시각화 도우미에서 열기

줄임표 메뉴 옵션의 다음 스크린샷을 고려합니다.

텍스트 시각화 도우미 옵션을 선택하면 텍스트가 더 큰 형식으로 표시된 모달 대화 상자가 열립니다. 텍스트 시각화 도우미 모달 대화 상자의 다음 스크린샷을 고려합니다.

일부 값은 JSON 또는 XML로 서식이 지정됩니다. 이러한 경우 텍스트 시각화 도우미를 사용하면 형식 선택 드롭다운에서 서로 다른 형식 간에 전환할 수 있습니다.

리소스 세부 정보

작업 열에서 줄임표 단추를 선택한 다음세부 정보 보기 선택하여 각 리소스에 대한 전체 세부 정보를 가져올 수 있습니다. 세부 정보 페이지에서는 리소스에 대한 포괄적인 보기를 제공합니다.

대시보드의 오른쪽 위에 있는 검색 창은 목록을 필터링하는 옵션도 제공합니다. 이 옵션은 리소스가 많은 .NET.NET Aspire 프로젝트에 유용합니다. 표시되는 리소스 유형을 선택하려면 필터 텍스트 상자의 왼쪽에 있는 화살표를 드롭다운합니다.

이 예제에서는 컨테이너만 목록에 표시됩니다. 예를 들어 프로젝트를 만들 때 캐싱 사용하도록 설정하면 컨테이너가 나열됩니다.

실행 파일은 독립 실행형 프로세스입니다. 기본 시작 템플릿에는 기본적으로 실행 파일이 포함되지 않지만 시작 중에 독립 실행형 실행 파일을 실행하도록 .NET.NET Aspire 프로젝트를 구성할 수 있습니다.

다음 스크린샷은 오류가 있는 프로젝트의 예를 보여줍니다.

오류 수 배지를 선택하면 리소스와 관련된 로그만 표시하도록 필터가 적용된 구조적 로그 페이지로 이동합니다.

오류에 대한 로그 항목을 자세히 보려면 보기 단추를 선택하여 구조화된 로그 항목 세부 정보가 포함된 목록 아래의 창을 엽니다.

구조적 로그에 대한 자세한 내용과 예제는 구조적 로그 페이지 섹션을 참조하세요.

모니터링 페이지

.NET .NET Aspire 대시보드는 앱에 대한 로그, 추적 및 메트릭을 보는 다양한 방법을 제공합니다. 이 정보를 통해 앱의 동작 및 성능을 추적하고 발생하는 문제를 진단할 수 있습니다.

콘솔 로그 페이지

콘솔 로그 페이지에는 앱의 각 리소스가 표준 출력으로 보낸 텍스트가 표시됩니다. 로그는 앱의 상태를 모니터링하고 문제를 진단하는 유용한 방법입니다. 로그는 프로젝트, 컨테이너 또는 실행 파일과 같은 원본에 따라 다르게 표시됩니다.

콘솔 로그 페이지를 열 때 리소스 드롭다운 목록에서 원본을 선택해야 합니다.

프로젝트를 선택하면 라이브 로그는 로그의 심각도에 해당하는 스타일이 지정된 색 집합으로 렌더링됩니다. 예를 들어 정보를 보려면 녹색입니다. apiservice 프로젝트가 선택된 프로젝트 로그의 다음 예제 스크린샷을 살펴보겠습니다.

오류가 발생하면 쉽게 식별할 수 있도록 로그에 스타일이 지정됩니다. 오류가 있는 프로젝트 로그의 다음 예제 스크린샷을 살펴보겠습니다.

컨테이너 또는 실행 파일을 선택하는 경우 서식은 프로젝트와 다르지만 자세한 동작 정보는 계속 사용할 수 있습니다. cache 컨테이너가 선택된 컨테이너 로그의 다음 예제 스크린샷을 살펴보겠습니다.

리소스 복제본

WithReplicas API를 사용하여 프로젝트 리소스를 복제하면 표시기 아이콘이 있는 최상위 리소스 항목 아래의 리소스 선택기에서 표시됩니다. 복제된 각 리소스는 해당 고유 이름을 사용하여 최상위 리소스 항목 아래에 나열됩니다. 복제된 프로젝트 리소스의 다음 예제 스크린샷을 살펴보겠습니다.

위의 스크린샷은 catalogservice (application) 및 catalogservice-2bpj2qdq6k두 개의 복제본이 있는 catalogservice-6ljdin0hc0 프로젝트를 보여줍니다. 각 복제본에는 복제본 이름을 선택하여 볼 수 있는 고유한 로그 집합이 있습니다.

구조적 로그 페이지

.NET Aspire OpenTelemetry사용하여 로깅을 사용하여 프로젝트를 자동으로 구성합니다. 구조적 로그 페이지로 이동하여 .NET.NET Aspire 프로젝트의 의미 체계 로그를 봅니다. 의미 체계 또는 구조화된 로깅 로그 이벤트 메시지 템플릿 및 메시지 매개 변수가 서식이 지정된 메시지로 변환하는 대신 유지되므로 로그 이벤트를 보다 쉽게 저장하고 쿼리할 수 있습니다. 열을 사용하여 페이지에 표시되는 여러 로그에 대한 정리된 구조를 확인할 수 있습니다.

• 리소스: 로그가 시작된 리소스입니다.
• 수준: 정보, 경고 또는 오류와 같은 항목의 로그 수준입니다.
• 타임스탬프: 로그가 발생한 시간입니다.
• 메시지: 로그의 세부 정보입니다.
• 추적: 해당하는 경우 로그에 대한 관련 추적에 대한 링크입니다.
• 세부 정보: 로그 항목에 대한 추가 세부 정보 또는 메타데이터입니다.

의미 체계 로그의 다음 예제 스크린샷을 고려합니다.

구조적 로그 필터링

구조화된 로그 페이지는 서비스, 수준 또는 메시지별로 로그를 필터링하는 검색 창도 제공합니다. 수준 드롭다운을 사용하여 로그 수준별로 필터링합니다. 고급 필터 대화 상자를 여는 필터 아이콘 단추를 선택하여 로그 속성을 필터링할 수도 있습니다.

메시지 텍스트에 "호스팅"이 있는 항목을 표시하도록 필터링된 구조적 로그를 보여 주는 다음 스크린샷을 고려합니다.

추적 페이지

추적 페이지로 이동하여 앱의 모든 추적을 봅니다. .NET .NET Aspire 앱의 여러 프로젝트에 대한 추적을 자동으로 구성합니다. 분산 추적은 엔지니어가 애플리케이션 내의 오류 및 성능 문제, 특히 여러 컴퓨터 또는 프로세스에 분산될 수 있는 문제를 지역화하는 데 도움이 되는 진단 기술입니다. 자세한 내용은 분산 추적 참조하세요. 이 기술은 애플리케이션을 통해 요청을 추적하고 다양한 애플리케이션 통합으로 수행된 작업의 상관 관계를 지정합니다. 추적은 요청의 여러 단계를 완료하는 데 걸린 기간을 식별하는 데도 도움이 됩니다. 추적 페이지에는 다음 정보가 표시됩니다.

• 타임스탬프: 추적이 완료된 경우
• 이름: 프로젝트 이름이 접두사로 지정된 추적의 이름입니다.
• 범위: 요청에 관련된 리소스입니다.
• 기간: 요청을 완료하는 데 걸린 시간입니다. 이 열에는 목록의 다른 항목과 비교하여 요청 기간을 보여 주는 방사형 아이콘이 포함되어 있습니다.

추적 필터링

추적 페이지는 이름 또는 범위별로 추적을 필터링하는 검색 창도 제공합니다. 필터를 적용하고 추적 결과가 즉시 업데이트되는지 확인합니다. 필터가 weather 적용된 추적의 다음 스크린샷을 고려하고 결과에서 검색 용어가 강조 표시된 방식을 확인합니다.

필터 추가 대화 상자에서 추적을 필터링하는 경우 매개 변수 및 해당 조건선택한 후 값 선택 영역은 선택한 매개 변수에 사용 가능한 값으로 미리 채워집니다. 매개 변수가 선택된 http.route 추가 대화 상자의 다음 스크린샷을 고려합니다.

여러 리소스의 원격 분석 결합

리소스에 복제본이 여러 개 있는 경우 원격 분석을 필터링하여 모든 인스턴스의 데이터를 한 번에 볼 수 있습니다. 다음 스크린샷과 같이 (application)레이블이 지정된 부모 리소스를 선택합니다.

모든 인스턴스별로 필터링

부모 리소스를 선택한 후 추적 페이지에는 리소스의 모든 인스턴스에서 원격 분석이 표시됩니다.

추적 세부 정보

추적 세부 정보 페이지에는 다음을 비롯한 요청과 관련한 다양한 세부 정보가 포함되어 있습니다.

• 추적 세부 정보: 추적이 시작된 경우입니다.
• 기간: 요청을 완료하는 데 걸린 시간입니다.
• 리소스: 요청에 관련된 리소스 수입니다.
• 깊이: 요청에 관련된 레이어 수입니다.
• 총 범위: 요청에 관련된 총 범위 수입니다.

각 범위는 테이블의 행으로 표시되며 Name포함합니다. 추적의 특정 범위 내에서 오류가 발생한 경우에도 범위는 오류 아이콘을 표시합니다. client/consumer 유형이 있지만 server범위가 없는 범위는 화살표 아이콘과 대상 주소를 표시합니다. 이는 client 프로젝트 외부의 시스템에 대한 .NET Aspire 호출을 나타냅니다. 예를 들어 HTTP는 외부 웹 API 또는 데이터베이스 호출을 요청합니다.

추적 세부 정보 페이지 내에는 요청과 관련된 로그만 표시하도록 필터가 적용된 구조화된 로그 페이지로 이동되는 로그 보기 단추가 있습니다. 추적과 관련된 로그만 표시하도록 필터가 적용된 구조적 로그 페이지를 보여 주는 예제 스크린샷을 생각해 보세요.

구조적 로그 페이지는 구조적 로그 페이지 섹션에서 자세히 설명합니다.

추적 예제

각 추적에는 각 리소스에 대해 하나의 색인 범위를 구분하는 데 도움이 되도록 생성되는 색이 있습니다. 색은 추적 페이지 및 추적 세부 정보 페이지모두에 반영됩니다. 추적에 화살표 아이콘이 표시되면 해당 아이콘은 대상 추적의 범위와 일치하도록 색이 지정됩니다. 추적의 다음 예제 스크린샷을 고려합니다.

보기 단추를 선택하여 각 애플리케이션 계층을 통해 이동하는 데 소요된 요청 및 기간에 대한 자세한 보기로 이동할 수도 있습니다. 추적의 예를 선택하여 세부 정보를 확인합니다.

추적의 각 범위에 대해 보기 선택하여 자세한 내용을 확인합니다.

전체 정보를 보려면 범위 세부 정보에서 아래로 스크롤합니다. 범위 세부 정보 창의 맨 아래에서 캐시에 대한 이 호출과 같은 일부 범위 유형은 범위 이벤트 타이밍을 표시합니다.

오류가 있으면 페이지에서 추적 이름 옆에 오류 아이콘을 렌더링합니다. 오류가 있는 추적의 예제 스크린샷을 생각해 보세요.

그리고 오류가 있는 추적의 해당 상세 보기:

메트릭 페이지

메트릭 페이지로 이동하여 앱의 메트릭을 봅니다. .NET .NET Aspire 앱의 여러 프로젝트에 대한 메트릭을 자동으로 구성합니다. 메트릭은 애플리케이션의 상태를 측정하는 방법이며 시간이 지남에 따라 앱의 성능을 모니터링하는 데 사용할 수 있습니다.

앱의 각 메트릭 게시 프로젝트에는 고유한 메트릭이 있습니다. 메트릭 페이지에는 각 최상위 미터에 대한 선택 창과 메트릭을 보기 위해 선택할 수 있는 해당 계측이 표시됩니다.

webfrontend 프로젝트가 선택되고 System.Net.Http 미터의 http.client.request.duration 메트릭이 선택된 메트릭 페이지의 다음 예제 스크린샷을 살펴보겠습니다.

메트릭 차트 외에도 메트릭 페이지에는 데이터를 테이블로 보는 옵션이 포함되어 있습니다. 테이블 보기가 선택된 메트릭 페이지의 다음 스크린샷을 살펴보세요.

차트 아래에는 관심 있는 데이터에 집중하기 위해 적용할 수 있는 필터 목록이 있습니다. 예를 들어 다음 스크린샷에서 http.request.method 필드는 GET 요청만 표시하도록 필터링됩니다.

값 대신 세로 액세스에서 표시된 메트릭의 수를 선택하도록 선택할 수도 있습니다.

메트릭에 대한 자세한 내용은 기본 제공 메트릭을 참조하세요.

예시

.NET Aspire 대시보드는 OpenTelemetryExemplars지원하고 표시합니다. 모범 메트릭 이벤트와 추적의 추가 연결 컨텍스트를 포함하는 기록된 값으로, 추적 신호를 메트릭과 연결하는 데 유용합니다.

모범 다음 데이터 요소로 구성됩니다.

• trace_id 및 span_id: (선택 사항) 추적 및 범위 식별자에 의해 식별되는 기록과 연결된 추적입니다.
• time_unix_nano: Unix 나노초로 표현된 관찰 시간입니다.
• value: 기록된 값입니다.
• filtered_attributes: 관찰이 수행될 때 추가 컨텍스트를 제공하는 필터링된 특성 집합입니다.

메트릭 차트에 데이터 요소 옆에 있는 작은 둥근 점으로 예시선이 표시됩니다. 표시기를 마우스로 가리키면 도구 설명에 다음 스크린샷과 같이 모범적인 세부 정보가 표시됩니다.

앞의 스크린샷은 http.client.request.duration 메트릭에 대한 모범적인 세부 정보를 보여줍니다. 모범적인 세부 정보에는 다음이 포함됩니다.

• 리소스 이름입니다.
• 이 경우 /catalog/images/{id}대한 HTTP GET이 수행되었습니다.
• 해당 값 및 타임스탬프를 반환합니다.

모범 표시기를 선택하면 연결된 추적을 볼 수 있는 추적 세부 정보 페이지가 열립니다. 예를 들어 다음 스크린샷을 고려하세요.

자세한 내용은 OpenTelemetry Docs: Exemplars참조하세요.

테마 선택

기본적으로 테마는 시스템 테마를 따르도록 설정됩니다. 즉, 대시보드가 운영 체제와 동일한 테마를 사용합니다. 밝은 선택하거나 어두운 테마를 시스템 테마를 재정의할 수도 있습니다. 테마 선택은 유지됩니다.

다음 스크린샷은 기본 시스템 테마가 선택된 테마 선택 대화 상자를 보여줍니다.

밝은 테마를 선호하는 경우 테마 선택 대화 상자에서 선택할 수 있습니다.

대시보드 바로 가기

대시보드는 대시보드의 여러 부분을 탐색하고 제어하는 데 도움이 되는 다양한 바로 가기를 제공합니다. 바로 가기 키를 표시하려면 Shift + ?를 누릅니다.대시보드의 오른쪽 위 모서리에서 물음표 아이콘을 선택합니다.

다음 바로 가기를 사용할 수 있습니다.

패널:

• +: 패널 크기를 늘입니다.
• -: 패널 크기를 줄입니다.
• Shift + r: Reset 패널 크기입니다.
• Shift + : Toggle 패널 방향입니다.
• Shift + x: 닫기 패널.

페이지 탐색:

• r: Resources이동합니다.
• c: C온솔 로그이동합니다.
• : S잘린 로그이동합니다.
• :T경주로 이동합니다.
• m: Metrics.

사이트 전체 탐색:

• ?: 도움말.
• Shift + : Settings이동합니다.

다음 단계