Integration API de test de charge

Ce guide explique comment utiliser le client API LoadFocus, a la fois via l'interface en ligne de commande (CLI) et en utilisant directement la bibliotheque JavaScript dans vos applications.

Table des matieres

• Installation
• Configuration
• Interface en ligne de commande (CLI)
  • Execution de tests JMeter
  • Surveillance de l'etat des tests
  • Recuperation des resultats
  • Travail avec les seuils
  • Formats de sortie
• Utilisation de la bibliotheque JavaScript
  • Configuration de base
  • Client JMeter
  • Execution de tests
  • Surveillance de l'etat des tests
  • Recuperation des resultats
  • Exemple complet
• Utilisation avancee
  • Configuration HTTP personnalisee
  • Gestion des erreurs
  • Execution parallele des tests
• Depannage

Installation

Installation globale

npm install -g @loadfocus/loadfocus-api-client

Installation dans un projet local

npm install @loadfocus/loadfocus-api-client

Configuration

Avant d'utiliser le client API LoadFocus, vous devez configurer vos identifiants API.

Configuration CLI

# Definir la cle API et l'ID d'equipe
loadfocus-api config set apikey YOUR_API_KEY
loadfocus-api config set teamid YOUR_TEAM_ID

# Verifier la configuration
loadfocus-api config show

Configuration JavaScript

const { configManager } = require('@loadfocus/loadfocus-api-client');

// Definir la configuration
configManager.set('apikey', 'YOUR_API_KEY');
configManager.set('teamid', 'YOUR_TEAM_ID');

// Verifier la configuration
console.log(configManager.get('apikey')); // Devrait afficher votre cle API
console.log(configManager.isConfigured()); // Devrait afficher true si toute la configuration requise est definie

Interface en ligne de commande (CLI)

Le client API LoadFocus fournit une CLI complete pour interagir avec l'API LoadFocus.

Execution de tests JMeter

Executer un test

# Executer un test par nom
loadfocus-api jmeter execute --name "My JMeter Test"

# Executer un test avec des parametres specifiques
loadfocus-api jmeter execute --name "My JMeter Test" --threads 50 --rampup 30 --duration 300

Executer un test et attendre la fin

# Executer un test et attendre la fin
loadfocus-api jmeter run-test --name "My JMeter Test"

# Executer un test avec des seuils
loadfocus-api jmeter run-test --name "My JMeter Test" --thresholds "avgresponse<=200,errors==0,p95<=250"

# Executer un test avec un delai d'attente et un intervalle d'interrogation personnalises
loadfocus-api jmeter run-test --name "My JMeter Test" --waitTimeout 1800 --pollInterval 15

Surveillance de l'etat des tests

# Verifier l'etat d'un test par nom et ID
loadfocus-api jmeter status --name "My JMeter Test" --id 12345

# Obtenir la liste des executions de test recentes
loadfocus-api jmeter runs --limit 10

Recuperation des resultats

# Obtenir les resultats d'un test specifique
loadfocus-api jmeter results --name "My JMeter Test" --id 12345

# Obtenir les resultats avec des metriques specifiques
loadfocus-api jmeter results --name "My JMeter Test" --id 12345 --include samples,avgresponse,errors

Travail avec les seuils

La commande run-test prend en charge l'evaluation des seuils pour determiner automatiquement si un test reussit ou echoue en fonction des metriques de performance.

# Executer un test avec plusieurs seuils
loadfocus-api jmeter run-test --name "My JMeter Test" --thresholds "avgresponse<=200,errors==0,p95<=250,hitspersec>=10"

Operateurs de seuil pris en charge :

• <= - Inferieur ou egal a
• < - Inferieur a
• >= - Superieur ou egal a
• > - Superieur a
• == - Egal a
• != - Different de

Formats de sortie

# Obtenir les resultats au format JSON
loadfocus-api jmeter run-test --name "My JMeter Test" --format json > results.json

# Sortie formatee par defaut
loadfocus-api jmeter run-test --name "My JMeter Test"

Utilisation de la bibliotheque JavaScript

Le client API LoadFocus peut egalement etre utilise directement comme bibliotheque JavaScript dans vos applications.

Configuration de base

// Importer le client API LoadFocus
const loadfocus = require('@loadfocus/loadfocus-api-client');

// Acceder aux composants specifiques
const { JMeterClient, configManager } = loadfocus;

Client JMeter

// Creer un client JMeter
const jmeterClient = new loadfocus.JMeterClient();

// Ou avec une configuration explicite
const jmeterClient = new loadfocus.JMeterClient({
  apikey: 'YOUR_API_KEY',
  teamid: 'YOUR_TEAM_ID'
});

Execution de tests

async function executeTest() {
  try {
    const result = await jmeterClient.execute({
      testrunname: 'My JMeter Test',
      threads: 50,
      rampup: 30,
      duration: 300
    });

    console.log('Test execution started:', result);
    return result.testrunid; // Retourner l'ID du test pour une utilisation ulterieure
  } catch (error) {
    console.error('Error executing test:', error);
  }
}

Surveillance de l'etat des tests

async function checkTestStatus(testName, testId) {
  try {
    const status = await jmeterClient.getStatus({
      testrunname: testName,
      testrunid: testId
    });

    console.log('Test status:', status);
    return status.state; // Retourner l'etat actuel
  } catch (error) {
    console.error('Error checking test status:', error);
  }
}

Recuperation des resultats

async function getTestResults(testName, testId) {
  try {
    // Obtenir les labels disponibles pour le test
    const labels = await jmeterClient.getLabels({
      testrunname: testName,
      testrunid: testId
    });

    console.log('Test labels:', labels);

    // Obtenir les resultats pour chaque label
    const allResults = [];
    for (const label of labels) {
      const labelResults = await jmeterClient.getResults({
        testrunname: testName,
        testrunid: testId,
        filter: label
      });

      allResults.push({
        label,
        results: labelResults
      });
    }

    console.log('Test results:', allResults);
    return allResults;
  } catch (error) {
    console.error('Error retrieving test results:', error);
  }
}

Exemple complet

Voici un exemple complet qui execute un test, attend la fin et recupere les resultats :

const { JMeterClient, configManager } = require('@loadfocus/loadfocus-api-client');

// Configurer
configManager.set('apikey', 'YOUR_API_KEY');
configManager.set('teamid', 'YOUR_TEAM_ID');

// Creer le client
const jmeterClient = new JMeterClient();

async function runCompleteTest() {
  try {
    // Executer le test
    console.log('Executing test...');
    const executeResult = await jmeterClient.execute({
      testrunname: 'My JMeter Test'
    });

    const testId = executeResult.testrunid;
    console.log(`Test execution started with ID: ${testId}`);

    // Attendre la fin
    console.log('Waiting for test to complete...');
    let completed = false;
    while (!completed) {
      const status = await jmeterClient.getStatus({
        testrunname: 'My JMeter Test',
        testrunid: testId
      });

      console.log(`Current state: ${status.state}`);

      if (status.state === 'finished') {
        completed = true;
      } else if (status.state === 'failed' || status.state === 'error') {
        throw new Error(`Test failed with state: ${status.state}`);
      } else {
        // Attendre avant de verifier a nouveau
        await new Promise(resolve => setTimeout(resolve, 10000));
      }
    }

    // Obtenir les resultats
    console.log('Getting test results...');
    const labels = await jmeterClient.getLabels({
      testrunname: 'My JMeter Test',
      testrunid: testId
    });

    const allResults = [];
    for (const label of labels) {
      const labelResults = await jmeterClient.getResults({
        testrunname: 'My JMeter Test',
        testrunid: testId,
        filter: label
      });

      allResults.push({
        label,
        results: labelResults
      });
    }

    console.log('Test results:', JSON.stringify(allResults, null, 2));
    return allResults;
  } catch (error) {
    console.error('Error running test:', error);
  }
}

// Executer le test
runCompleteTest();

Utilisation avancee

Configuration HTTP personnalisee

Vous pouvez personnaliser le client HTTP utilise par le client API LoadFocus :

const { JMeterClient } = require('@loadfocus/loadfocus-api-client');

// Creer un client avec des options HTTP personnalisees
const jmeterClient = new JMeterClient({
  apikey: 'YOUR_API_KEY',
  teamid: 'YOUR_TEAM_ID',
  httpOptions: {
    timeout: 30000, // 30 secondes
    retries: 3,
    headers: {
      'User-Agent': 'My Custom Application'
    }
  }
});

Gestion des erreurs

Le client API LoadFocus fournit des informations detaillees sur les erreurs :

try {
  const result = await jmeterClient.execute({
    testrunname: 'My JMeter Test'
  });
} catch (error) {
  if (error.response) {
    // La requete a ete effectuee et le serveur a repondu avec un code d'etat
    // en dehors de la plage 2xx
    console.error('API Error:', error.response.status, error.response.data);
  } else if (error.request) {
    // La requete a ete effectuee mais aucune reponse n'a ete recue
    console.error('Network Error:', error.request);
  } else {
    // Quelque chose s'est passe lors de la configuration de la requete qui a declenche une erreur
    console.error('Request Error:', error.message);
  }
}

Depannage

Problemes courants

1. Erreurs d'authentification :

   • Assurez-vous que votre cle API et votre ID d'equipe sont correctement configures
   • Verifiez que votre cle API dispose des autorisations necessaires

2. Echecs d'execution de tests :

   • Verifiez que le nom du test existe dans votre compte LoadFocus
   • Verifiez si vous avez atteint la limite de tests simultanes de votre compte

3. Problemes de delai d'attente :

   • Pour les tests de longue duree, augmentez le parametre waitTimeout
   • Envisagez d'implementer un mecanisme d'interrogation au lieu d'attendre de maniere synchrone

4. Problemes de recuperation des resultats :

   • Assurez-vous que le test est termine avant de recuperer les resultats
   • Verifiez que l'ID du test est correct

Debogage

Activez la journalisation de debogage pour obtenir des informations plus detaillees :

// Dans votre code JavaScript
process.env.DEBUG = 'true';

// Ou lors de l'utilisation du CLI
DEBUG=true loadfocus-api jmeter run-test --name "My JMeter Test"

Pour une aide supplementaire, veuillez consulter la documentation de l'API LoadFocus ou contacter le support.