Datadog APM on RHEL · Hands-on Lab

02 · READINESS

ข้อมูลที่ต้องพร้อม

เก็บข้อมูลชุดนี้ก่อนเริ่ม เพื่อไม่ให้ต้องหยุดกลางทาง

EC2 & NetworkRHEL 8/9, SSH ได้, outbound TCP 443

Privilegeบัญชีที่ใช้ sudo หรือ root ได้

DatadogAPI Key และเลือก Site ถูกต้อง

Service identityservice, env และ version ที่ตกลงแล้ว

PHP pathรู้ตำแหน่ง www.conf และ socket/port

Test trafficเรียก URL ของ PHP จาก localhost ได้

Parameter	ค่าที่ใช้ในแลป	ปรับเมื่อใด
Operating system	`RHEL 8 / RHEL 9`	คำสั่งนี้ใช้ dnf และ systemd
Datadog site	`datadoghq.com`	เปลี่ยนให้ตรงกับ Organization
Service	`customer-demo-php`	ตั้งชื่อตาม application จริง
Environment	`lab`	เช่น dev, uat, prd
Version	`1.0.0`	ใช้ release หรือ commit SHA
PHP-FPM socket	`/run/php-fpm/www.sock`	ตรวจจาก directive `listen`

DATADOG APM · HANDS-ON

ติดตั้งบน EC2 RHEL

ทำตามลำดับ Apache → PHP-FPM → Datadog Agent/SSI → Integrations → ตรวจสอบ traces

CHECKPOINT 01

สำรวจเครื่องก่อนติดตั้ง

3 min

บันทึก OS, เวอร์ชัน runtime, สถานะ service และ endpoint ของ PHP-FPM ก่อนแก้ configuration

bash · EC2

cat /etc/redhat-release
php -v || true
php-fpm -v || true
httpd -v || true

sudo systemctl status httpd --no-pager || true
sudo systemctl status php-fpm --no-pager || true
sudo grep -E '^[; ]*listen[ .=]' /etc/php-fpm.d/www.conf || true

# ตรวจ outbound ที่ Agent ต้องใช้
curl -I --max-time 10 https://app.datadoghq.com

✓

ผ่านเมื่อ ยืนยันได้ว่าเป็น RHEL 8/9 และออก HTTPS ไป Datadog ได้

CHECKPOINT 02

ติดตั้ง Apache และ PHP-FPM

5 min

ติดตั้ง package มาตรฐานของ RHEL แล้วเปิด service ให้เริ่มพร้อมระบบ

bash · EC2

sudo dnf install -y httpd php php-fpm php-cli curl
sudo systemctl enable --now php-fpm httpd

sudo apachectl configtest
systemctl is-active httpd php-fpm
curl -I http://127.0.0.1/

✓

ผ่านเมื่อ configtest แสดง Syntax OK และ service ทั้งสองเป็น active

CHECKPOINT 03

สร้าง PHP endpoint สำหรับยิง traffic

5 min

ตัวอย่างมี latency หลายช่วงเพื่อให้ trace flame graph อ่านง่าย โดยไม่ต้องมีฐานข้อมูลภายนอก

bash · EC2

sudo tee /var/www/html/index.php >/dev/null <<'PHP'
<?php
header('Content-Type: application/json');

function loadCatalog(): array {
    usleep(random_int(15000, 45000));
    return ['agent', 'apm', 'integration'];
}

$started = microtime(true);
$items = loadCatalog();
usleep(random_int(5000, 20000));

echo json_encode([
    'service' => 'customer-demo-php',
    'status' => 'ok',
    'items' => $items,
    'duration_ms' => round((microtime(true) - $started) * 1000, 2)
], JSON_PRETTY_PRINT);
PHP

sudo restorecon -Rv /var/www/html
curl -s http://127.0.0.1/index.php

✓

ผ่านเมื่อ ได้ JSON ที่มี "status": "ok"

CHECKPOINT 04 · CORE

ติดตั้ง Datadog Agent + Single Step APM

10 min

Secret handling

ใช้ API key จากหน้า Agent Installation ของ Organization จริง ห้าม commit key ลง Git, Terraform state หรือเอกสารนี้

bash · EC2

read -rsp 'Datadog API key: ' DD_API_KEY && echo
export DD_API_KEY

DD_SITE="datadoghq.com" \
DD_APM_INSTRUMENTATION_ENABLED="host" \
bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.sh)"

unset DD_API_KEY
sudo datadog-agent status
sudo systemctl is-active datadog-agent

bash · ตรวจ SSI

sudo cat /etc/ld.so.preload
sudo find /opt/datadog-packages -maxdepth 2 -type d -name '*apm*' -print

✓

ผ่านเมื่อ Agent เป็น active และมี Datadog APM injector/package บน host

CHECKPOINT 05

กำหนด Unified Service Tags

7 min

PHP-FPM มักใช้ clear_env=yes จึงกำหนดค่าผ่าน env[] ใน pool โดยตรง แล้ว restart runtime เพื่อโหลด tracer

ini · /etc/php-fpm.d/www.conf

env[DD_SERVICE] = customer-demo-php
env[DD_ENV] = lab
env[DD_VERSION] = 1.0.0
env[DD_APM_TRACING_ENABLED] = 1
env[DD_LOGS_INJECTION] = 1

bash · apply & inspect

sudo php-fpm -t
sudo systemctl restart php-fpm httpd
sudo systemctl restart datadog-agent

php-fpm -i | grep -iE 'ddtrace|datadog|dd_library_loader'

✓

ผ่านเมื่อ output ของ PHP-FPM พบ ddtrace หรือ Datadog library loader

CHECKPOINT 06

เปิด Apache และ PHP-FPM integrations

12 min

6.1 Apache mod_status

apache · /etc/httpd/conf.d/datadog-status.conf

<Location "/server-status">
    SetHandler server-status
    Require local
</Location>

ExtendedStatus On

yaml · /etc/datadog-agent/conf.d/apache.d/conf.yaml

init_config:

instances:
  - apache_status_url: http://127.0.0.1/server-status?auto
    tags:
      - env:lab
      - service:customer-demo-php

6.2 PHP-FPM status และ ping

ini · เพิ่มใน /etc/php-fpm.d/www.conf

pm.status_path = /status
ping.path = /ping
ping.response = pong

apache · เพิ่มใน datadog-status.conf

<LocationMatch "^/(status|ping)$">
    SetHandler "proxy:unix:/run/php-fpm/www.sock|fcgi://localhost/"
    Require local
</LocationMatch>

yaml · /etc/datadog-agent/conf.d/php_fpm.d/conf.yaml

init_config:

instances:
  - status_url: http://127.0.0.1/status
    ping_url: http://127.0.0.1/ping
    ping_reply: pong
    tags:
      - env:lab
      - service:customer-demo-php

bash · restart & verify

sudo apachectl configtest
sudo php-fpm -t
sudo systemctl restart php-fpm httpd datadog-agent

curl -s 'http://127.0.0.1/server-status?auto' | head
curl -s http://127.0.0.1/status | head
curl -s http://127.0.0.1/ping

sudo datadog-agent check apache
sudo datadog-agent check php_fpm

✓

ผ่านเมื่อ Apache และ PHP-FPM checks แสดง [OK] และ ping ตอบ pong

CHECKPOINT 07

สร้าง traffic และยืนยัน trace

5 min

bash · EC2

for i in {1..30}; do
  curl -fsS http://127.0.0.1/index.php >/dev/null
  sleep 0.2
done

sudo datadog-agent status
sudo datadog-agent health

จากนั้นไปที่ APM → Traces ใน Datadog แล้ว filter ด้วย:

service:customer-demo-php AND env:lab

✓

ผ่านเมื่อ เห็น request traces, runtime fpm-fcgi และ Agent รายงาน traces/spans มากกว่า 0

05 · RECOVERY

Troubleshooting map

เริ่มจาก symptom แล้วไล่ตรวจจุดที่ใกล้ที่สุดก่อน

01Agent ทำงาน แต่ไม่มี trace+

ตรวจว่า restart PHP-FPM หลังติดตั้ง SSI แล้ว, loader ถูกโหลด และมี request วิ่งเข้า PHP จริง

sudo systemctl restart php-fpm httpd
php-fpm -i | grep -iE 'ddtrace|datadog|dd_library_loader'
sudo datadog-agent status

02Apache check เชื่อมต่อไม่ได้+

ทดสอบ URL เดียวกับใน config และยืนยันว่า Require local อนุญาต localhost

curl -v 'http://127.0.0.1/server-status?auto'
sudo apachectl -M | grep status
sudo journalctl -u httpd -n 50 --no-pager

03PHP-FPM status ได้ 404 / 503+

ตรวจ socket จาก directive listen, module proxy_fcgi และ syntax ของทั้งสอง service

sudo grep -E '^listen|^pm.status_path|^ping.path' /etc/php-fpm.d/www.conf
sudo apachectl -M | grep proxy_fcgi
sudo ls -l /run/php-fpm/www.sock

04SELinux หรือ permission ขวางการเชื่อมต่อ+

อย่าปิด SELinux เพื่อแก้ลัด ตรวจ audit log และคืน context ของ web root ก่อน

getenforce
sudo restorecon -Rv /var/www/html
sudo ausearch -m AVC -ts recent | tail -30

05ต้องเก็บ log เพิ่มเพื่อส่ง Support+

สร้าง flare หลัง reproduce ปัญหา โดยตรวจข้อมูลลับก่อน upload ทุกครั้ง

sudo datadog-agent flare
sudo journalctl -u datadog-agent -n 100 --no-pager
sudo tail -100 /var/log/php-fpm/error.log

มองเห็นทุก request
จาก Apache ถึง PHP

เห็นภาพก่อนลงมือ

ข้อมูลที่ต้องพร้อม

ติดตั้งบน EC2 RHEL

สำรวจเครื่องก่อนติดตั้ง

ติดตั้ง Apache และ PHP-FPM

สร้าง PHP endpoint สำหรับยิง traffic

ติดตั้ง Datadog Agent + Single Step APM

กำหนด Unified Service Tags

เปิด Apache และ PHP-FPM integrations

6.1 Apache mod_status

6.2 PHP-FPM status และ ping

สร้าง traffic และยืนยัน trace

Definition of done

Troubleshooting map

ค่าที่ตั้งใจให้ปลอดภัยตั้งแต่ต้น

มองเห็นทุก requestจาก Apache ถึง PHP

เห็นภาพก่อนลงมือ

ข้อมูลที่ต้องพร้อม

ติดตั้งบน EC2 RHEL

สำรวจเครื่องก่อนติดตั้ง

ติดตั้ง Apache และ PHP-FPM

สร้าง PHP endpoint สำหรับยิง traffic

ติดตั้ง Datadog Agent + Single Step APM

กำหนด Unified Service Tags

เปิด Apache และ PHP-FPM integrations

6.1 Apache mod_status

6.2 PHP-FPM status และ ping

สร้าง traffic และยืนยัน trace

Definition of done

Troubleshooting map

ค่าที่ตั้งใจให้ปลอดภัยตั้งแต่ต้น

มองเห็นทุก request
จาก Apache ถึง PHP