Skip to main content

How to block grafana

Operated by Grafana Labs. Synthetic Monitoring agent executes network checks and probes from global locations to test website availability, performance, and API functionality, providing re… Developer Helper Assists with testing, debugging, and ensuring website functionality

How it identifies itself

synthetic-monitoring-agent/v0.20.1-0-g66af84ad (linux amd64; 66af84ad6a8755895d4b69606281ca7354c1589a; 2024-02-12 16:50:07+00:00; +https://github.com/grafana/synthetic-monitoring-agent)

robots.txt

What the agent asks to be told. It obeys this or it does not — nothing enforces it.

robots.txt
User-agent: grafana
Disallow: /

nginx

In the server block, then reload.

nginx
# In the server block. 403 rather than 444: a closed connection tells the
# operator nothing, and an agent that gets a status code can log it.
if ($http_user_agent ~* "(grafana|Grafana-Synthetic-Monitoring)") {
    return 403;
}

Apache

In .htaccess or the vhost.

Apache
BrowserMatchNoCase "grafana" bad_bot
BrowserMatchNoCase "Grafana-Synthetic-Monitoring" bad_bot

<RequireAll>
    Require all granted
    Require not env bad_bot
</RequireAll>

Cloudflare

Security → WAF → Custom rules.

Cloudflare
# Security → WAF → Custom rules, action: Block
(http.user_agent contains "grafana") or (http.user_agent contains "Grafana-Synthetic-Monitoring")

WordPress

A child theme's functions.php, or a small plugin.

WordPress
// functions.php of a child theme, or a small plugin. Runs before WordPress
// builds the page, so a blocked agent costs one PHP process and no queries.
add_action('init', function () {
    $agent = $_SERVER['HTTP_USER_AGENT'] ?? '';

    foreach (['grafana', 'Grafana-Synthetic-Monitoring'] as $needle) {
        if (stripos($agent, $needle) !== false) {
            status_header(403);
            exit('Blocked: grafana');
        }
    }
});

robots.txt is a request. The rules below it are the wall.

grafana publishes a token, so the directive above will work for as long as it keeps honouring it — and nothing except its own good manners makes it. The server rules match on a header the requester sets, which stops the agent that says who it is and not the one that copies somebody else's name. Botscope verifies identity against DNS and published address ranges, records which check decided each request, and shows you the ones that lied.

Others like it

Everything we know about grafana