|
|
- <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="highlight"><pre><span></span><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> -X POST --data-raw <span class="s2">"</span><span class="nv">$m</span><span class="s2">"</span> PING_URL
- </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="highlight"><pre><span></span><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> -X POST --data-raw <span class="s2">"</span><span class="nv">$m</span><span class="s2">"</span> <span class="nv">$url</span>
- </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="highlight"><pre><span></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><span class="p">;</span> curl -fsS -X POST --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>
- </pre></div>
|
