docs: build de 1b37bd6b4b
This commit is contained in:
parent
314bcd7d4e
commit
3a7372b546
12 changed files with 249 additions and 70 deletions
|
|
@ -347,6 +347,7 @@
|
|||
<nav aria-label="Page">
|
||||
<ul class="visible nav section-nav flex-column">
|
||||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#metriques-prometheus">Métriques Prometheus</a></li>
|
||||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#connaissance-de-l-hote">Connaissance de l’hôte</a></li>
|
||||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#watchdog">Watchdog</a></li>
|
||||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#journaux">Journaux</a></li>
|
||||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#inspection-de-la-base">Inspection de la base</a></li>
|
||||
|
|
@ -399,6 +400,29 @@
|
|||
durable sur <code class="docutils literal notranslate"><span class="pre">error</span></code> est l’alerte la plus utile à poser ; une valeur durable sur <code class="docutils literal notranslate"><span class="pre">creating</span></code>
|
||||
ou <code class="docutils literal notranslate"><span class="pre">deleting</span></code> signale une opération qui n’aboutit pas.</p>
|
||||
</section>
|
||||
<section id="connaissance-de-l-hote">
|
||||
<h2>Connaissance de l’hôte<a class="headerlink" href="#connaissance-de-l-hote" title="Lien vers cette rubrique">#</a></h2>
|
||||
<p>Deux routes de l’API de l’agent, en lecture seule (voir <a class="reference internal" href="api-agent/reference.html"><span class="doc">Référence</span></a>) :</p>
|
||||
<dl class="simple">
|
||||
<dt><code class="docutils literal notranslate"><span class="pre">GET</span> <span class="pre">/register</span></code></dt><dd><p>ce qui ne change pas tant que l’hôte tourne : hostname, CPU (fabricant, modèle, sockets,
|
||||
cœurs, threads), RAM totale, OS (<code class="docutils literal notranslate"><span class="pre">/etc/os-release</span></code>) et noyau. Lu une fois au démarrage de
|
||||
l’agent ; si la lecture échoue, l’agent démarre quand même, journalise <code class="docutils literal notranslate"><span class="pre">host</span> <span class="pre">facts</span>
|
||||
<span class="pre">unavailable</span></code> et la route répond 503 avec l’erreur.</p>
|
||||
</dd>
|
||||
<dt><code class="docutils literal notranslate"><span class="pre">GET</span> <span class="pre">/ping</span></code></dt><dd><p>l’état courant : version de l’agent, démarrage de l’hôte (<code class="docutils literal notranslate"><span class="pre">boot_time</span></code>) et de l’agent
|
||||
(<code class="docutils literal notranslate"><span class="pre">agent_start_time</span></code>), uptime de l’hôte et load sur 1, 5 et 15 minutes. Mesuré au démarrage
|
||||
puis toutes les <code class="docutils literal notranslate"><span class="pre">times.host_state_interval</span></code> secondes (10 par défaut), gardé en mémoire ;
|
||||
<code class="docutils literal notranslate"><span class="pre">collected_at</span></code> donne l’heure de la mesure. 503 tant qu’aucune mesure n’a réussi ; une mesure
|
||||
en échec est journalisée (<code class="docutils literal notranslate"><span class="pre">host</span> <span class="pre">state</span> <span class="pre">collection</span> <span class="pre">failed</span></code>) et la précédente reste servie.</p>
|
||||
</dd>
|
||||
</dl>
|
||||
<p>Les dates sont des timestamps Unix en secondes. Un <code class="docutils literal notranslate"><span class="pre">boot_time</span></code> qui change signale un
|
||||
redémarrage de l’hôte, un <code class="docutils literal notranslate"><span class="pre">agent_start_time</span></code> seul un redémarrage de l’agent ;
|
||||
<code class="docutils literal notranslate"><span class="pre">boot_time</span></code> + <code class="docutils literal notranslate"><span class="pre">uptime_seconds</span></code> donne l’horloge de l’hôte au moment de la mesure.</p>
|
||||
<p>La version de l’agent est injectée au build : le tag pour une release, le commit court
|
||||
(suffixé <code class="docutils literal notranslate"><span class="pre">-dirty</span></code> si l’arbre avait des modifications) pour les binaires de test du lab,
|
||||
<code class="docutils literal notranslate"><span class="pre">undefined</span></code> sinon. Elle figure aussi dans la ligne <code class="docutils literal notranslate"><span class="pre">starting</span> <span class="pre">agent</span></code> du journal.</p>
|
||||
</section>
|
||||
<section id="watchdog">
|
||||
<h2>Watchdog<a class="headerlink" href="#watchdog" title="Lien vers cette rubrique">#</a></h2>
|
||||
<p>Une goroutine périodique vérifie que les ressources marquées <code class="docutils literal notranslate"><span class="pre">running</span></code> en base existent
|
||||
|
|
@ -420,8 +444,8 @@ numéro du VNI.</p>
|
|||
<li><p><code class="docutils literal notranslate"><span class="pre">two-hostsvc</span></code> injoignable sur sa socket de contrôle : une notification, aucun VPC de
|
||||
l’hyperviseur n’a plus de DNS ni de NTP ;</p></li>
|
||||
<li><p>pour chaque VPC <code class="docutils literal notranslate"><span class="pre">running</span></code> : VPC absent de la liste servie par <code class="docutils literal notranslate"><span class="pre">two-hostsvc</span></code>,
|
||||
<code class="docutils literal notranslate"><span class="pre">169.254.169.253</span></code> absente de la <code class="docutils literal notranslate"><span class="pre">dummy</span></code> <code class="docutils literal notranslate"><span class="pre">hostsvc</span></code>, ou chaîne <code class="docutils literal notranslate"><span class="pre">TWO-HOSTSVC</span></code> absente ou
|
||||
incomplète dans son netns. Un VPC créé par une version antérieure à la 0.3.0 n’a rien de tout
|
||||
<code class="docutils literal notranslate"><span class="pre">169.254.169.253</span></code> absente de la <code class="docutils literal notranslate"><span class="pre">dummy</span></code> <code class="docutils literal notranslate"><span class="pre">hostsvc</span></code>, ou chaîne <code class="docutils literal notranslate"><span class="pre">hostsvc</span></code> de la table
|
||||
<code class="docutils literal notranslate"><span class="pre">ip</span> <span class="pre">two</span></code> absente ou incomplète dans son netns. Un VPC créé par une version antérieure à la 0.3.0 n’a rien de tout
|
||||
cela : il est signalé à chaque tick jusqu’à sa recréation.</p></li>
|
||||
</ul>
|
||||
<p>Avec une section <code class="docutils literal notranslate"><span class="pre">bgp</span></code> dans la configuration, il contrôle aussi le plan de contrôle :</p>
|
||||
|
|
@ -533,6 +557,7 @@ deux processus ne doivent pas ouvrir la même instance.</p>
|
|||
<nav id="pst-page-toc-nav" class="page-toc" aria-labelledby="pst-page-navigation-heading-2">
|
||||
<ul class="visible nav section-nav flex-column">
|
||||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#metriques-prometheus">Métriques Prometheus</a></li>
|
||||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#connaissance-de-l-hote">Connaissance de l’hôte</a></li>
|
||||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#watchdog">Watchdog</a></li>
|
||||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#journaux">Journaux</a></li>
|
||||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#inspection-de-la-base">Inspection de la base</a></li>
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue