dotnet clean arch

C#의 깨끗한 건축 예

이 저장소는 날씨 HTTP API와 통합 된 C# 솔루션에서 클린 아키텍처 를 구현하여 모니터링 및 관찰 가능성을 위해 Prometheus 및 Grafana 와 같은 필수 현대 도구를 통합합니다.

프로젝트 구조

이 프로젝트는 깨끗한 아키텍처 구조를 따릅니다.

• CleanArch.Api : 컨트롤러, 구성 및 종속성 분사 설정을 포함하는 웹 API 계층.
• CleanArch.Domain : 핵심 비즈니스 논리 및 도메인 엔티티.
• CleanArch.Application : 응용 프로그램 별 논리 및 사용 사례.
• CleanArch.Infrastructure : 외부 서비스 통합 및 데이터 지속성과 같은 인프라 코드.

라이브러리 및 도구

이 프로젝트는 다음 라이브러리와 도구를 사용합니다.

• ASP.NET CORE : 웹 API를 구축합니다.
• SERILOG : 로깅의 경우.
• Prometheus.net : 응용 프로그램 메트릭 노출.
• Docker Compose : API, Prometheus 및 Grafana와 같은 서비스를 조정하는 것.

모니터링 및 관찰 가능성

이 프로젝트에는 docker-compose.yml 파일이 포함되어 있습니다.

• PROMETHEUS : API에 노출 된 메트릭을 긁어냅니다.
• Grafana : Prometheus의 메트릭을 시각화합니다.

메트릭 엔드 포인트

이 응용 프로그램은 Prometheus.net 라이브러리를 사용하여 /metrics 에서 메트릭을 노출시킵니다.

설정 지침

전제 조건

• Docker와 Docker Compose가 설치되었습니다.
• 날씨 API 통합을위한 Weatherstack API 키.

단계

1. 저장소 복제 :

git clone https://github.com/MatheusSw/dotnet-clean-arch.git
cd CleanArch

2. 시스템 환경 변수에 Weatherstack API 키 추가
3. Docker Compose를 사용하여 응용 프로그램을 빌드하고 실행하십시오.

docker-compose up --build

4. 서비스 액세스 :

• API : http : // localhost : 8080
• Prometheus : http : // localhost : 9090
• Grafana : http : // localhost : 3000

메트릭 시각화

1. http : // localhost : 3000 (기본 관리자/관리자)에서 Grafana에 로그인하십시오.
2. Prometheus를 데이터 소스로 추가하십시오. (Prometheus : 9090 사용 URL로 사용)
3. 사전 구성된 대시 보드를 가져 오거나 API 성능을 모니터링하기 위해 사용자 정의 대시 보드를 작성하십시오.

예제 API 엔드 포인트

• get /weathers?location=Brasil Sao Paulo : Weatherstack API를 사용하여 특정 위치에 대한 날씨 정보를 가져옵니다.