|
<h1>Attaching Logs</h1>
|
|
<p>SITE_NAME ping endpoints accept HTTP HEAD, GET and POST request methods.</p>
|
|
<p>When using HTTP POST, <strong>you can include arbitrary payload in the request body</strong>.
|
|
If the request body looks like a UTF-8 string, SITE_NAME will log the first 10 kilobytes of
|
|
the request body, so you can inspect it later.</p>
|
|
<h2>Logging Command Output</h2>
|
|
<p>In this example, we run <code>certbot renew</code>, capture its output, and submit
|
|
the captured output to SITE_NAME:</p>
|
|
<div class="bash highlight"><pre><span></span><code><span class="ch">#!/bin/sh</span>
|
|
|
|
<span class="nv">m</span><span class="o">=</span><span class="k">$(</span>/usr/bin/certbot renew <span class="m">2</span>><span class="p">&</span><span class="m">1</span><span class="k">)</span>
|
|
curl -fsS --retry <span class="m">3</span> --data-raw <span class="s2">"</span><span class="nv">$m</span><span class="s2">"</span> PING_URL
|
|
</code></pre></div>
|
|
|
|
|
|
<h2>In Combination with the <code>/fail</code> Endpoint</h2>
|
|
<p>We can extend the previous example and signal either success or failure
|
|
depending on the exit code:</p>
|
|
<div class="bash highlight"><pre><span></span><code><span class="ch">#!/bin/sh</span>
|
|
|
|
<span class="nv">url</span><span class="o">=</span>PING_URL
|
|
|
|
<span class="nv">m</span><span class="o">=</span><span class="k">$(</span>/usr/bin/certbot renew <span class="m">2</span>><span class="p">&</span><span class="m">1</span><span class="k">)</span>
|
|
|
|
<span class="k">if</span> <span class="o">[</span> <span class="nv">$?</span> -ne <span class="m">0</span> <span class="o">]</span><span class="p">;</span> <span class="k">then</span> <span class="nv">url</span><span class="o">=</span><span class="nv">$url</span>/fail<span class="p">;</span> <span class="k">fi</span>
|
|
curl -fsS --retry <span class="m">3</span> --data-raw <span class="s2">"</span><span class="nv">$m</span><span class="s2">"</span> <span class="nv">$url</span>
|
|
</code></pre></div>
|
|
|
|
|
|
<h2>All in One Line</h2>
|
|
<p>Finally, all of the above can be packaged in a single line. The one-line
|
|
version can be put directly in crontab, without using a wrapper script.</p>
|
|
<div class="bash highlight"><pre><span></span><code><span class="nv">m</span><span class="o">=</span><span class="k">$(</span>/usr/bin/certbot renew <span class="m">2</span>><span class="p">&</span><span class="m">1</span><span class="k">)</span><span class="p">;</span> curl -fsS --data-raw <span class="s2">"</span><span class="nv">$m</span><span class="s2">"</span> <span class="s2">"PING_URL</span><span class="k">$(</span><span class="o">[</span> <span class="nv">$?</span> -ne <span class="m">0</span> <span class="o">]</span> <span class="o">&&</span> <span class="nb">echo</span> -n /fail<span class="k">)</span><span class="s2">"</span>
|
|
</code></pre></div>
|