Documentation PulseRadar

curl -sSL https://pulseradar.cloud/install.sh | bash -s -- --api-key <VOTRE_CLÉ>

# Installation automatique (recommandée)
curl -sSL https://pulseradar.cloud/install.sh | bash -s -- --api-key <CLÉ>

# Options disponibles
--api-key <CLÉ>        Clé API (obligatoire)
--server-name <NOM>    Nom affiché dans le dashboard (défaut: hostname)

# PowerShell en administrateur
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
iex (New-Object Net.WebClient).DownloadString('https://pulseradar.cloud/install.ps1')

# Statut
sudo systemctl status pulseradar-agent

# Redémarrage
sudo systemctl restart pulseradar-agent

# Logs de l'agent
sudo journalctl -u pulseradar-agent -f

/etc/pulseradar/agent.conf        Configuration de l'agent
/etc/fluent-bit/fluent-bit.conf Configuration Fluent Bit (auto-généré)
/etc/fluent-bit/parsers.conf    Parseurs de logs

{
  "level":     "error",          // fatal|critical|error|warning|info|debug
  "message":   "Connection refused to database",
  "source":    "mon-app",        // identifiant libre de la source
  "timestamp": "2026-03-30T14:00:00Z",  // optionnel, défaut: maintenant
  "host":      "web01",          // optionnel
  "fields": {                    // données structurées libres
    "user_id": "42",
    "duration_ms": "320"
  }
}

# Log unique
curl -X POST https://ingest.pulseradar.cloud/v1/logs \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"level":"error","message":"Oops","source":"mon-app"}'

# Batch (jusqu'à 500 événements par requête)
curl -X POST https://ingest.pulseradar.cloud/v1/logs \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '[{"level":"info","message":"Start"},{"level":"error","message":"Fail"}]'

npm install @pulseradar/sdk

const PulseRadar = require('@pulseradar/sdk')

const logger = new PulseRadar({
  apiKey:   process.env.PULSERADAR_API_KEY,
  serverId: process.env.PULSERADAR_SERVER_ID, // optionnel
  source:   'mon-app',
})

logger.info('Démarrage du serveur', { port: '3000' })
logger.error('Erreur DB', { query: 'SELECT ...' })

// Capture automatique d'exceptions
try {
  riskyOperation()
} catch (err) {
  logger.captureException(err, { context: 'riskyOperation' })
}

pip install pulseradar

from pulseradar import PulseRadar
import os

logger = PulseRadar(
    api_key=os.environ["PULSERADAR_API_KEY"],
    server_id=os.environ.get("PULSERADAR_SERVER_ID"),  # optionnel
    source="mon-app",
)

logger.info("Démarrage", version="1.0")
logger.error("Erreur DB", query="SELECT ...")

# Capture d'exception
try:
    risky()
except Exception:
    logger.capture_exception()

composer require pulseradar/pulseradar-php

use PulseRadarPulseRadar;

$logger = new PulseRadar([
    'api_key'   => getenv('PULSERADAR_API_KEY'),
    'server_id' => getenv('PULSERADAR_SERVER_ID'), // optionnel
    'source'    => 'mon-app',
    'async'     => true,  // batch + flush au __destruct
]);

$logger->info('Démarrage');
$logger->error('Erreur DB', ['query' => 'SELECT ...']);

// Capture d'exception
try {
    risky();
} catch (Throwable $e) {
    $logger->captureException($e);
}

gem install pulseradar

require 'pulseradar'

logger = PulseRadar::Client.new(
  api_key:   ENV['PULSERADAR_API_KEY'],
  server_id: ENV['PULSERADAR_SERVER_ID'],  # optionnel
  source:    'mon-app',
)

logger.info('Démarrage', port: '3000')
logger.error('Erreur DB', query: 'SELECT ...')

# Capture d'exception
begin
  risky_operation
rescue => e
  logger.capture_exception(e, context: 'risky')
end

<!-- pom.xml -->
<dependency>
  <groupId>cloud.pulseradar</groupId>
  <artifactId>pulseradar-java</artifactId>
  <version>1.0.0</version>
</dependency>

PulseRadar logger = new PulseRadar.Builder()
    .apiKey(System.getenv("PULSERADAR_API_KEY"))
    .source("my-app")
    .build();

logger.info("Server started", Map.of("port", "8080"));
logger.error("DB connection failed");

try { riskyOperation(); }
catch (Exception e) { logger.captureException(e); }

<!-- logback.xml -->
<appender name="PULSERADAR" class="cloud.pulseradar.PulseRadarLogbackAppender">
  <apiKey>${PULSERADAR_API_KEY}</apiKey>
  <source>my-app</source>
</appender>
<root level="WARN">
  <appender-ref ref="PULSERADAR" />
</root>

[INPUT]
    Name   tail
    Path   /var/log/mon-app/*.log
    Tag    mon-app

[FILTER]
    Name   record_modifier
    Match  mon-app
    Record source mon-app
    Record server_id ${SERVER_ID}
    Record project_id ${PROJECT_ID}

[OUTPUT]
    Name        http
    Match       mon-app
    Host        ingest.pulseradar.cloud
    Port        443
    URI         /v1/logs/fluent-bit
    Format      json
    Header      Authorization Bearer ${API_KEY}

log_format pulseradar '$remote_addr - $remote_user [$time_local] '
                    '"$request" $status $body_bytes_sent '
                    '"$http_referer" "$http_user_agent" '
                    'rt=$request_time';

access_log /var/log/nginx/access.log pulseradar;

# /etc/mysql/mysql.conf.d/mysqld.cnf
slow_query_log        = 1
slow_query_log_file   = /var/log/mysql/slow.log
long_query_time       = 0.5      # requêtes > 500ms
log_queries_not_using_indexes = 1

# /etc/postgresql/*/main/postgresql.conf
log_min_duration_statement = 500   # ms — requêtes > 500ms
log_line_prefix = '%t [%p]: [%l-1] user=%u,db=%d,app=%a,client=%h '

slowlog = /var/log/php-fpm-slow.log
request_slowlog_timeout = 2s

Avant :  SELECT * FROM users WHERE id = 42 AND status = 'active'
Après :  SELECT * FROM users WHERE id = ? AND status = ?

Avant :  SELECT * FROM orders WHERE id IN (1, 2, 3, 4, 5)
Après :  SELECT * FROM orders WHERE id IN (?)

POST https://ingest.pulseradar.cloud/v1/traces
Authorization: Bearer <API_KEY>
X-Server-Id: <SERVER_ID>
Content-Type: application/json

export OTEL_EXPORTER_OTLP_ENDPOINT=https://ingest.pulseradar.cloud
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer <API_KEY>,X-Server-Id=<SERVER_ID>"
export OTEL_EXPORTER_OTLP_PROTOCOL=http/json
export OTEL_SERVICE_NAME=mon-app

npm install @opentelemetry/sdk-node @opentelemetry/exporter-trace-otlp-http

const { NodeSDK } = require('@opentelemetry/sdk-node')
const { OTLPTraceExporter } = require('@opentelemetry/exporter-trace-otlp-http')

new NodeSDK({
  traceExporter: new OTLPTraceExporter({
    url: 'https://ingest.pulseradar.cloud/v1/traces',
    headers: {
      'Authorization': 'Bearer <API_KEY>',
      'X-Server-Id': '<SERVER_ID>',
    },
  }),
  serviceName: 'mon-app',
}).start()

pip install opentelemetry-sdk opentelemetry-exporter-otlp-proto-http

from opentelemetry.sdk.trace.export import BatchSpanProcessor
from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter

provider.add_span_processor(BatchSpanProcessor(OTLPSpanExporter(
    endpoint="https://ingest.pulseradar.cloud/v1/traces",
    headers={"Authorization": "Bearer <API_KEY>", "X-Server-Id": "<SERVER_ID>"}
)))

composer require open-telemetry/sdk open-telemetry/exporter-otlp

# .env
OTEL_PHP_AUTOLOAD_ENABLED=true
OTEL_EXPORTER_OTLP_ENDPOINT=https://ingest.pulseradar.cloud
OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer <API_KEY>,X-Server-Id=<SERVER_ID>"

Authorization: Bearer <API_KEY>

GET /v1/logs?project_id=<ID>&level=error&limit=100
Authorization: Bearer <API_KEY>