Status200
Probe

# Setting up Custom Probes

You can set up custom probes inside your network to monitor resources in your private network or resources that are behind your firewall.

To begin with you need to create a custom probe in your Project Settings > Probe. Once you have created the custom probe on your Status200 Dashboard. You should have the PROBE_ID and PROBE_KEY

Deploy Probe

Docker

To run a probe, please make sure you have docker installed. You can run custom probe by:

docker run --name status200-probe --network host -e PROBE_KEY=<probe-key> -e PROBE_ID=<probe-id> -e S200_URL=https://status200.ru -d status200/probe:release

If you are self hosting Status200, you can change S200_URL to your custom self hosted instance.

Proxy Configuration

If your probe needs to go through a proxy server to reach Status200 or monitor external resources, you can configure proxy settings using these environment variables:

# For HTTP proxy
docker run --name status200-probe --network host \
  -e PROBE_KEY=<probe-key> \
  -e PROBE_ID=<probe-id> \
  -e S200_URL=https://status200.ru \
  -e HTTP_PROXY_URL=http://proxy.example.com:8080 \
  -e NO_PROXY=localhost,.internal.example.com \
  -d status200/probe:release

# For HTTPS proxy
docker run --name status200-probe --network host \
  -e PROBE_KEY=<probe-key> \
  -e PROBE_ID=<probe-id> \
  -e S200_URL=https://status200.ru \
  -e HTTPS_PROXY_URL=http://proxy.example.com:8080 \
  -e NO_PROXY=localhost,.internal.example.com \
  -d status200/probe:release

# With proxy authentication
docker run --name status200-probe --network host \
  -e PROBE_KEY=<probe-key> \
  -e PROBE_ID=<probe-id> \
  -e S200_URL=https://status200.ru \
  -e HTTP_PROXY_URL=http://username:password@proxy.example.com:8080 \
  -e HTTPS_PROXY_URL=http://username:password@proxy.example.com:8080 \
  -e NO_PROXY=localhost,.internal.example.com \
  -d status200/probe:release

Docker Compose

You can also run the probe using docker-compose. Create a docker-compose.yml file with the following content:

version: "3"

services:
  status200-probe:
    image: status200/probe:release
    container_name: status200-probe
    environment:
      - PROBE_KEY=<probe-key>
      - PROBE_ID=<probe-id>
      - S200_URL=https://status200.ru
    network_mode: host
    restart: always
With Proxy Configuration

If you need to use a proxy server, you can add proxy environment variables:

version: "3"

services:
  status200-probe:
    image: status200/probe:release
    container_name: status200-probe
    environment:
      - PROBE_KEY=<probe-key>
      - PROBE_ID=<probe-id>
      - S200_URL=https://status200.ru
      # Proxy configuration (optional)
      - HTTP_PROXY_URL=http://proxy.example.com:8080
      - HTTPS_PROXY_URL=http://proxy.example.com:8080
      - NO_PROXY=localhost,.internal.example.com
      # For proxy with authentication:
      # - HTTP_PROXY_URL=http://username:password@proxy.example.com:8080
      # - HTTPS_PROXY_URL=http://username:password@proxy.example.com:8080
      # - NO_PROXY=localhost,.internal.example.com
    network_mode: host
    restart: always

Then run the following command:

docker compose up -d

If you are self hosting Status200, you can change S200_URL to your custom self hosted instance.

Kubernetes

You can also run the probe using Kubernetes. Create a status200-probe.yaml file with the following content:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: status200-probe
spec:
  selector:
    matchLabels:
      app: status200-probe
  template:
    metadata:
      labels:
        app: status200-probe
    spec:
      containers:
      - name: status200-probe
        image: status200/probe:release
        env:
          - name: PROBE_KEY
            value: "<probe-key>"
          - name: PROBE_ID
            value: "<probe-id>"
          - name: S200_URL
            value: "https://status200.ru"
With Proxy Configuration

If you need to use a proxy server, you can add proxy environment variables:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: status200-probe
spec:
  selector:
    matchLabels:
      app: status200-probe
  template:
    metadata:
      labels:
        app: status200-probe
    spec:
      containers:
      - name: status200-probe
        image: status200/probe:release
        env:
          - name: PROBE_KEY
            value: "<probe-key>"
          - name: PROBE_ID
            value: "<probe-id>"
          - name: S200_URL
            value: "https://status200.ru"
          # Proxy configuration (optional)
          - name: HTTP_PROXY_URL
            value: "http://proxy.example.com:8080"
          - name: HTTPS_PROXY_URL
            value: "http://proxy.example.com:8080"
          - name: NO_PROXY
            value: "localhost,.internal.example.com"
          # For proxy with authentication, use:
          # - name: HTTP_PROXY_URL
          #   value: "http://username:password@proxy.example.com:8080"
          # - name: HTTPS_PROXY_URL
          #   value: "http://username:password@proxy.example.com:8080"
          # - name: NO_PROXY
          #   value: "localhost,.internal.example.com"

Then run the following command:

kubectl apply -f status200-probe.yaml

If you are self hosting Status200, you can change S200_URL to your custom self hosted instance.

Environment Variables

The probe supports the following environment variables:

Required Variables

  • PROBE_KEY - The probe key from your Status200 dashboard
  • PROBE_ID - The probe ID from your Status200 dashboard
  • S200_URL - The URL of your Status200 instance (default: https://status200.ru)

Optional Variables

  • HTTP_PROXY_URL - HTTP proxy server URL for HTTP requests
  • HTTPS_PROXY_URL - HTTP proxy server URL for HTTPS requests
  • NO_PROXY - Comma-separated hosts or domains that should bypass the proxy
  • PROBE_NAME - Custom name for the probe
  • PROBE_DESCRIPTION - Description for the probe
  • PROBE_MONITORING_WORKERS - Number of monitoring workers (default: 1)
  • PROBE_MONITOR_FETCH_LIMIT - Number of monitors to fetch at once (default: 10)
  • PROBE_MONITOR_RETRY_LIMIT - Number of retries for failed monitors (default: 3)
  • PROBE_SYNTHETIC_MONITOR_SCRIPT_TIMEOUT_IN_MS - Timeout for synthetic monitor scripts in milliseconds (default: 60000)
  • PROBE_CUSTOM_CODE_MONITOR_SCRIPT_TIMEOUT_IN_MS - Timeout for custom code monitor scripts in milliseconds (default: 60000)

Proxy Configuration

The probe supports both HTTP and HTTPS proxy servers. When configured, the probe will route all monitoring traffic through the specified proxy servers. You can also provide a comma-separated NO_PROXY list to bypass the proxy for internal hosts or networks.

Proxy URL Format:

http://[username:password@]proxy.server.com:port

Examples:

  • Basic proxy: http://proxy.example.com:8080
  • With authentication: http://username:password@proxy.example.com:8080

Supported Features:

  • HTTP and HTTPS proxy support
  • Proxy authentication (username/password)
  • Automatic fallback between HTTP and HTTPS proxies
  • Selective proxy bypass using NO_PROXY
  • Works with all monitor types (Website, API, SSL, Synthetic, etc.)

Note: Both standard environment variables (HTTP_PROXY_URL, HTTPS_PROXY_URL, NO_PROXY) and lowercase variants (http_proxy, https_proxy, no_proxy) are supported for compatibility.

if you see problems in documents, please send us email