Skip to content

docs: add PHP SSI operational guidance to README #271

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
trevdem wants to merge 1 commit into
base: master
Choose a base branch
from
Open

docs: add PHP SSI operational guidance to README #271

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -96,6 +96,12 @@ Download and import the [relevant libraries][6] to send data. To learn more, che
| `DD_TRACE_PHP_VERSION` | Pin the PHP tracer version installed by SSI. Defaults to `1.19.2`. |
| `DD_WAIT_TRACE_AGENT` | Use this option to delay the startup of the application until the Trace Agent is ready. This option is especially useful for Golang apps. |

**PHP SSI notes:**

- **Disk quota:** PHP apps using SSI typically need `disk_quota: 2048M` (or higher) in `manifest.yml`. The default 1 GB is often not enough to stage `php_buildpack`'s runtime plus the tracer installed at container start.
- **Runtime network:** Unlike other SSI runtimes, PHP downloads `datadog-setup.php` from GitHub on each container start. Outbound access to `github.com` is required unless you provide an alternate install path.
- **Startup delay:** The PHP tracer is installed when `.profile.d` scripts run. Web processes and sidecars may contend on a lock during install, which can add up to 120 seconds to startup on the first process start.

### Log collection

**Enable log collection**
Expand Down