Guide de configuration
Personnalisez la configuration de votre cluster NATS pour des performances et une fiabilité optimales.
Configuration du cluster
Gestion des versions
Mettez à jour votre version NATS :
- Accédez à votre cluster
- Cliquez sur Mettre à jour
- Sélectionnez la nouvelle version
- Appliquez les changements
Les mises à jour de version déclenchent un redémarrage progressif. Planifiez les mises à jour pendant les périodes de faible trafic.
Mise à l'échelle des ressources
Classe de calcul
| Classe | Description | Cas d'utilisation |
|---|---|---|
| Eco | Ressources partagées, économique | Développement, tests |
| Standard | Performance équilibrée | Production |
| Production | Ressources dédiées | Charges critiques |
Options de flavor
Les flavors varient selon la classe de calcul. Voir Créer un cluster pour les spécifications détaillées.
| Classe de calcul | Small | Medium | Large | XLarge |
|---|---|---|---|---|
| Eco (1:2) | 0.5 vCPU, 1 Gi | 1 vCPU, 2 Gi | 2 vCPU, 4 Gi | 3 vCPU, 6 Gi |
| Standard (1:4) | 1 vCPU, 4 Gi | 2 vCPU, 8 Gi | 4 vCPU, 16 Gi | 15 vCPU, 58 Gi |
| Production (1:4) | 1 vCPU, 4 Gi | 2 vCPU, 8 Gi | 4 vCPU, 16 Gi | 6 vCPU, 28 Gi |
Processus de mise à l'échelle
- Accédez aux paramètres du cluster
- Sélectionnez une nouvelle classe de calcul ou flavor
- Appliquez les changements
- La mise à jour progressive se fait automatiquement
Configuration des réplicas
| Réplicas | Tolérance aux pannes | Performance |
|---|---|---|
| 1 | Aucune | Maximale |
| 3 | 1 défaillance de nœud | Équilibrée |
| 5 | 2 défaillances de nœuds | Redondante |
Utilisez 3 réplicas en production. Cela fournit une tolérance aux pannes tout en maintenant de bonnes performances.
Configuration JetStream
Activer/Désactiver JetStream
- Accédez aux paramètres du cluster
- Basculez JetStream on/off
- Appliquez les changements
Désactiver JetStream supprimera tous les streams, consumers, stores KV et stores d'objets.
Configuration des streams
Types de stockage
| Type | Persistance | Performance | Cas d'utilisation |
|---|---|---|---|
| File | Persistant | Bonne | Production |
| Memory | Non-persistant | Excellente | Cache, données temporaires |
Paramètres de rétention
// Rétention basée sur les limites
{
retention: 'limits',
max_msgs: 1000000,
max_bytes: 1073741824, // 1GB
max_age: 604800000000000 // 7 jours (nanosecondes)
}
// Rétention basée sur l'intérêt
{
retention: 'interest'
// Messages supprimés quand pas de consumers
}
// Rétention work queue
{
retention: 'workqueue'
// Messages supprimés après accusé de réception
}
Réplication
| Paramètre | Description |
|---|---|
| 1 | Pas de réplication (développement) |
| 3 | HA standard |
| 5 | Durabilité maximale |
Configuration des consumers
Politiques de livraison
| Politique | Commencer depuis |
|---|---|
all | Début du stream |
new | Nouveaux messages uniquement |
last | Dernier message |
by_start_sequence | Numéro de séquence spécifique |
by_start_time | Timestamp spécifique |
Politiques d'accusé de réception
| Politique | Description |
|---|---|
none | Pas d'accusé de réception requis |
all | Accuser réception de tous les messages jusqu'à la séquence |
explicit | Chaque message accusé individuellement |
Paramètres de re-livraison
{
max_deliver: 5, // Tentatives de livraison maximales
ack_wait: 30000000000, // 30 secondes (nanosecondes)
max_ack_pending: 1000 // Messages non-accusés maximum
}
Configuration des stores Key-Value
| Paramètre | Description | Défaut |
|---|---|---|
| History | Révisions par clé | 1 |
| TTL | Expiration des entrées | Aucun |
| Max Value Size | Taille max des valeurs en octets | -1 (illimité) |
| Max Bytes | Stockage total | -1 (illimité) |
| Replicas | Nombre de copies | 1 |
Configuration des stores d'objets
| Paramètre | Description | Défaut |
|---|---|---|
| Max Bytes | Stockage total | -1 (illimité) |
| Storage | File ou Memory | File |
| Replicas | Nombre de copies | 1 |
Configuration de connexion
Format de la chaîne de connexion
nats://{cluster-name}.{namespace}:{port}
Exemple :
nats://my-nats.my-project-abc123:4222
Options client
JavaScript/TypeScript
import { connect } from 'nats';
const nc = await connect({
servers: 'nats://my-nats.my-project-abc123:4222',
// Options de connexion
reconnect: true,
maxReconnectAttempts: -1, // Illimité
reconnectTimeWait: 1000, // 1 seconde
// Timeouts
timeout: 10000, // 10 secondes
pingInterval: 30000, // 30 secondes
// Paramètres de buffer
maxPingOut: 2,
noEcho: true
});
Go
nc, err := nats.Connect(
"nats://my-nats.my-project-abc123:4222",
nats.MaxReconnects(-1),
nats.ReconnectWait(time.Second),
nats.Timeout(10*time.Second),
nats.PingInterval(30*time.Second),
nats.MaxPingsOutstanding(2),
)
Python
nc = await nats.connect(
"nats://my-nats.my-project-abc123:4222",
reconnect_time_wait=1,
max_reconnect_attempts=-1,
connect_timeout=10,
ping_interval=30
)
Bonnes pratiques de connexion
- Activer la reconnexion automatique : Toujours configurer la reconnexion automatique
- Définir des timeouts appropriés : Équilibrer réactivité et fiabilité
- Gérer les déconnexions : Implémenter une gestion d'erreurs appropriée
nc.status().subscribe((status) => {
switch (status.type) {
case 'disconnect':
console.log('Déconnecté de NATS');
break;
case 'reconnect':
console.log('Reconnecté à NATS');
break;
case 'error':
console.error('Erreur NATS :', status.data);
break;
}
});
Variables d'environnement
Configurez votre application avec ces variables d'environnement :
# Connexion
NATS_URL=nats://my-nats.my-project-abc123:4222
# Authentification optionnelle
NATS_USER=admin
NATS_PASSWORD=your-password
# Le TLS managé n'est pas encore disponible ; les endpoints SailOps utilisent actuellement nats://.
Optimisation des performances
Débit de messages
Pour un haut débit :
| Paramètre | Recommandation |
|---|---|
| Publication par lots | Publier par lots de 100-1000 |
| Publication asynchrone | Utiliser fire-and-forget quand la durabilité n'est pas nécessaire |
| Parallélisme des consumers | Multiples consumers avec queue groups |
// Publication par lots
const js = nc.jetstream();
const promises = messages.map(msg =>
js.publish('events.batch', JSON.stringify(msg))
);
await Promise.all(promises);
Optimisation mémoire
| Paramètre | Recommandation |
|---|---|
| Taille des messages | Garder les messages petits (moins de 1MB) |
| Rétention des streams | Définir des limites appropriées |
| Prefetch des consumers | Limiter max_ack_pending |
Optimisation de la latence
| Paramètre | Recommandation |
|---|---|
| Réplicas | Utiliser 3 pour équilibrer latence/durabilité |
| Stockage | Utiliser Memory pour la latence minimale |
| Accusé de réception | Utiliser la politique none si la durabilité n'est pas critique |
Configuration du monitoring
Métriques à surveiller
| Métrique | Seuil d'alerte |
|---|---|
| Utilisation CPU | >80% |
| Utilisation mémoire | >85% |
| Nombre de connexions | Proche du max |
| Taux de messages | Baisses inattendues |
| Retard des consumers | >10000 en attente |
Configuration des alertes
- Allez dans Monitoring → Alertes
- Créez une règle d'alerte pour les métriques NATS
- Configurez les canaux de notification
- Définissez des seuils appropriés
Sauvegarde et récupération
Sauvegarde des streams
Exportez les données du stream pour la sauvegarde :
const stream = await js.streams.get('ORDERS');
// Exporter les messages
const consumer = await stream.getConsumer('backup-consumer');
const messages = [];
for await (const msg of consumer.consume()) {
messages.push({
subject: msg.subject,
data: msg.data,
headers: msg.headers
});
msg.ack();
}
// Sauvegarder dans un fichier
fs.writeFileSync('backup.json', JSON.stringify(messages));
Récupération des streams
Importez les données sauvegardées :
const backup = JSON.parse(fs.readFileSync('backup.json'));
const js = nc.jetstream();
for (const msg of backup) {
await js.publish(msg.subject, msg.data, {
headers: msg.headers
});
}
Dépannage
Utilisation mémoire élevée
- Vérifiez les limites de stockage des streams
- Revoyez les paramètres de rétention des messages
- Purgez les anciens messages si nécessaire
- Envisagez de passer de Memory à File
Consumers lents
- Augmentez les instances de consumers
- Utilisez des queue groups pour la distribution de charge
- Optimisez le traitement des messages
- Augmentez max_ack_pending
Problèmes de connexion
- Vérifiez la chaîne de connexion
- Vérifiez la connectivité réseau
- Revoyez les règles de firewall
- Assurez-vous que le cluster est en cours d'exécution