要在PHP應用程序中集成Prometheus監控,您需要遵循以下步驟:
安裝Prometheus PHP客戶端庫:
首先,您需要在PHP項目中安裝Prometheus客戶端庫。這個庫可以幫助您收集和暴露指標。推薦使用promphp/prometheus_client_php
庫。通過Composer安裝:
composer require promphp/prometheus_client_php
創建一個指標收集器:
接下來,您需要創建一個PHP類,該類將負責收集和提供應用程序的性能指標。例如,您可以創建一個名為AppMetricsCollector.php
的文件,并添加以下內容:
<?php
use Prometheus\CollectorRegistry;
use Prometheus\RenderTextFormat;
use Prometheus\Storage\InMemory;
class AppMetricsCollector
{
private $registry;
public function __construct()
{
$this->registry = new CollectorRegistry(new InMemory());
}
public function collectRequestDuration($duration)
{
$histogram = $this->registry->getOrRegisterHistogram(
'app',
'request_duration_seconds',
'The request duration in seconds.',
['route']
);
$histogram->observe($duration, ['route' => $_SERVER['REQUEST_URI']]);
}
public function renderMetrics()
{
$renderer = new RenderTextFormat();
return $renderer->render($this->registry->getMetricFamilySamples());
}
}
在這個示例中,我們創建了一個名為AppMetricsCollector
的類,它包含一個方法collectRequestDuration()
用于收集請求持續時間指標,以及一個方法renderMetrics()
用于渲染指標。
在應用程序中使用指標收集器:
現在,您需要在應用程序中使用AppMetricsCollector
類。在每個請求開始時,記錄請求開始時間。在請求結束時,計算請求持續時間并將其傳遞給collectRequestDuration()
方法。例如,在一個基于PHP的Web應用程序中,您可以在index.php
文件中添加以下代碼:
<?php
require_once 'vendor/autoload.php';
require_once 'AppMetricsCollector.php';
$metricsCollector = new AppMetricsCollector();
// Record the start time of the request
$startTime = microtime(true);
// Your application logic here...
// Calculate the request duration
$duration = microtime(true) - $startTime;
// Collect the request duration metric
$metricsCollector->collectRequestDuration($duration);
// Expose the metrics to Prometheus
header('Content-Type: text/plain');
echo $metricsCollector->renderMetrics();
配置Prometheus:
最后,您需要在Prometheus服務器上配置一個新的作業(job),以便從您的PHP應用程序收集指標。編輯Prometheus配置文件(通常是prometheus.yml
),并添加以下內容:
scrape_configs:
- job_name: 'my_php_app'
static_configs:
- targets: ['your-php-app-url:9091'] # Replace 'your-php-app-url' with your PHP app URL and port
保存更改并重新啟動Prometheus服務器。
現在,您已經成功地將PHP應用程序與Prometheus監控集成。您可以使用Prometheus查詢語言(PromQL)查詢和分析應用程序的性能指標。