dotnet clean arch

Exemple d'architecture propre en C #

Ce référentiel fournit une implémentation de l' architecture propre dans une solution C # intégrant avec une API HTTP météorologique, intégrant des outils modernes essentiels comme Prometheus et Grafana pour la surveillance et l'observabilité.

Structure du projet

Ce projet suit la structure de l'architecture propre:

• CleanArch.Api : la couche API Web, contenant des contrôleurs, une configuration et une configuration d'injection de dépendance.
• CleanArch.Domain : Core Business Logic and Domain Entities.
• CleanArch.Application : Logique et cas d'utilisation spécifiques à l'application.
• CleanArch.Infrastructure : code d'infrastructure tel que l'intégration de service externe et la persistance des données.

Bibliothèques et outils

Le projet utilise les bibliothèques et les outils suivants:

• ASP.NET Core : pour la création de l'API Web.
• Serilog : pour journalisation.
• PROMETHEUS.NET : Pour exposer les mesures d'application.
• Docker Compose : pour les services d'orchestration comme l'API, Prométhée et Grafana.

Surveillance et observabilité

Le projet comprend un fichier docker-compose.yml qui configure:

• Prométhée : gratter les mesures exposées par l'API.
• Grafana : Pour visualiser les mesures de Prometheus.

Point de terminaison des mesures

L'application expose les métriques à /metrics à l'aide de la bibliothèque prometheus.net .

Instructions de configuration

Condition préalable

• Docker et Docker composent installés.
• Clé API Weatherstack pour l'intégration de l'API météorologique.

Mesures

1. Clone le référentiel:

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

2. Ajoutez votre clé API Weathersmack à vos variables d'environnement système
3. Créer et exécuter l'application à l'aide de Docker Compose:

docker-compose up --build

4. Accéder aux services:

• API : http: // localhost: 8080
• Prométhée : http: // localhost: 9090
• Grafana : http: // localhost: 3000

Visualiser les mesures

1. Connectez-vous à Grafana sur http: // localhost: 3000 (par défaut admin / admin).
2. Ajoutez Prometheus comme source de données. (Utilisez Prometheus: 9090 comme URL)
3. Importez des tableaux de bord préconfigurés ou créez des personnaux personnalisés pour surveiller les performances de l'API.

Exemple de points de terminaison API

• Get /weathers?location=Brasil Sao Paulo : Répondance aux informations météorologiques pour un emplacement spécifique à l'aide de l'API Weatherstack.