Intramedial est en bêta restreinte. À l’inscription ou à la connexion, vous devez fournir le mot de passe de bêta-testeur que vous avez reçu ou en demander un à preview@intramedial.com. Merci.
Chargement…
metering.snapshotModule 21
Module du plan
Metered usage by workspace
Voyez ce que le plan de contrôle a compté pour votre espace de travail, compteur par compteur, et quel compteur de facturation chaque total alimente.
metering.snapshot renvoie les compteurs de l'espace de travail : actions coordonnées, agents actifs, arènes, recherches, portes et le reste. Le plan de contrôle incrémente chacun au fil du travail, et aucune requête ne peut déclarer d'usage. Le snapshot nomme aussi le compteur de facturation auquel chaque total correspond.
Les agents agissent quand le plan dit oui, et le registre dit pourquoi.
Faites passer actions d’agents, hash de contenu, contrôles d’API, requêtes DNS, webhooks, appels LLM et commits git par Intramedial. Obtenez un reçu signé vérifiable par tous – sans nous croire.
Actions coordonnées : chaque appel à coordination/admit, quel que soit son résultat.
parley.arenas
Arènes ouvertes, avec parley.local.anchor, parley.arena_hours et parley.participant_agents à côté.
gatehouse.lookups
Recherches d'annuaire, avec gatehouse.doors et gatehouse.matters à côté.
arbitration.cases
Dossiers d'arbitrage ouverts.
yards.instances
Instances de Yard démarrées, avec negotiate.sessions à côté.
Mécanisme
Pas à pas
Comment ça marche
Le plan de contrôle compte
Les admissions, inscriptions, ouvertures d'arène, recherches d'annuaire et événements similaires appellent le pont de mesure depuis l'intérieur du plan de contrôle, au moment où ils se produisent.
Les totaux sont tenus par espace de travail
Chaque total est stocké dans le magasin de politiques propre à l'espace de travail. Un espace de travail n'ajoute jamais aux totaux d'un autre.
Le snapshot les lit
GET /api/v1/acp/metering/snapshot renvoie le total actuel de chaque compteur, et l'identifiant du compteur de facturation que chacun alimente.
Les déclarations sont refusées
Une requête vers metering/emit est refusée. Un compteur compte ce que le plan de contrôle a fait, et rien de ce qu'envoie un appelant ne le modifie.
Essayer
Démo en direct
Exécutez-le depuis cette page
GET/api/v1/acp/metering/snapshot
// Pas de corps : c’est un GET. Appuyez sur Exécuter.
S’exécute dans un workspace de démonstration partagé avec une clé de démonstration : tout le monde peut voir ce qu’il contient, n’envoyez donc rien de privé. Docs metering.snapshot
Réponses
Appuyez sur Exécuter pour envoyer la requête de gauche au workspace de démonstration partagé.
S’exécute dans un workspace de démonstration partagé avec une clé de démonstration : tout le monde peut voir ce qu’il contient, n’envoyez donc rien de privé.
Code
Exemple en direct
Une vraie requête
Une requête dans la forme acceptée par l’API, et un exemple de réponse dans la forme renvoyée par le module.
Un responsable financier lit coordination.admissions et identity.active_agents par rapport à l'offre, et voit le total avant la facture.
Repérer le compteur le plus actif
Un ingénieur voit gatehouse.lookups loin devant tous les autres compteurs et remonte jusqu'à une boucle dans un agent.
Rapprocher l'usage de la facturation
billingMeterIds liste le compteur de facturation que chaque total alimente, de sorte qu'une ligne d'usage peut être reliée au compteur qui la sous-tend.
Avant et après un déploiement
Lisez le snapshot, activez une nouvelle flotte d'agents, relisez-le. La différence est ce que le déploiement a coûté en travail compté.
Quand utiliser autre chose
Voir qui détient une ressource ou qui attend. Utilisez coordination.lease pour la file et coordination.fleetmap pour les leases.
Fixer un plafond de dépenses. Les budgets relèvent de la politique et vivent dans vos mandats ; voir mandates.compile.
Trouver quelle action a été comptée. Un compteur n'a aucun détail ; utilisez ledger.blame pour l'enregistrement de ce qui s'est passé.
Preuves
Garanties
Ce qu’il fait, et ce qu’il ne fait pas
Un module est une affirmation forte sur un sujet étroit. Fiez-vous-y exactement pour ce qu’il est.
Il le fait
Chaque compteur est incrémenté par du code interne au plan de contrôle, et metering/emit est refusé pour toute requête.
Les totaux sont stockés par espace de travail : un snapshot ne montre donc que le vôtre.
Chaque nom de compteur correspond à un seul identifiant de compteur de facturation, listé dans la même réponse.
Il ne le fait pas
Ce que coûte un total. Les tarifs vivent dans la configuration de facturation et ne figurent pas dans cette réponse.
Qu'un total est définitif. Un compteur continue de compter, et un snapshot est un instant.
Quel agent a causé un total. Un compteur est un total, sans détail par agent ni par action.
L'identifiant d'un compteur de facturation est le nom du compteur avec chaque . remplacé par _ : coordination.admissions alimente donc coordination_admissions.
Les files d'attente sont ailleurs
La page Commons du tableau de bord montre aussi les agents en attente et les enveloppes de budget. Elles viennent de coordination/wait et treasury/envelopes, pas de ce snapshot.
Limites et mesure
La route est un GET sans paramètre. Elle renvoie tous les compteurs et n'accepte aucun filtre.
Seules certaines routes comptent : coordination/admit, identity/enroll et identity/scim, parley/open, directory/lookup et arbitration/open, entre autres. Les lectures et la plupart des autres routes ne comptent pas.
metering/emit est refusé pour les requêtes : l'usage ne peut donc pas être ajouté à la main.
La lecture du snapshot n'est pas mesurée.
Accès
API et MCP
REST et MCP
Authentifiez-vous avec une clé d’API d’espace de travail comme jeton Bearer. L’URL de base est https://api.intramedial.com.
Points d’accès REST
GET/api/v1/acp/metering/snapshotLire le total de chaque compteur et son identifiant de compteur de facturation.
Actions MCP
MCPcoordination.metering.snapshotLire le snapshot de mesure comme action MCP.
Exigez deux administrateurs différents avant que les actions les plus destructrices du plan de contrôle ne s'exécutent, et voyez si le sceau bris de glace est intact.
Module du plan
