-
-
Notifications
You must be signed in to change notification settings - Fork 7
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Adds information about client configuration for http-dumps and xhprof
fixes #4
- Loading branch information
1 parent
953cb50
commit 19ba80a
Showing
2 changed files
with
41 additions
and
2 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -13,4 +13,25 @@ For instance, let's say you have a POST request: `http:https://[email protected]:800 | |
server will intercept the request and capture all the relevant information. It will then display the | ||
dumped data, allowing you to examine the request details, including the URI segments (`user/3/update` in this example). | ||
|
||
![http dumps](https://github.com/buggregator/server/assets/773481/fc823390-b490-4bbb-a787-44471eca9fb6) | ||
![http dumps](https://github.com/buggregator/server/assets/773481/fc823390-b490-4bbb-a787-44471eca9fb6) | ||
|
||
## Client configuration | ||
|
||
There are several ways to say Buggregator that your request is a dump request: | ||
|
||
### Using http auth | ||
|
||
Add `http-dump` to the host name, e.g. `http:https://http-dump@...` | ||
|
||
```curl | ||
curl --location 'http:https://[email protected]:8000?foo=bar' | ||
``` | ||
|
||
### Using header | ||
|
||
Add a header `X-Buggregator-Event` with value `http-dump` | ||
|
||
```curl | ||
curl --location 'http:https://127.0.0.1:8000?foo=bar' \ | ||
--header 'X-Buggregator-Event: http-dump' | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -51,5 +51,23 @@ configure the profiler. | |
|
||
```dotenv | ||
PROFILER_ENDPOINT=http:https://[email protected]:8000 | ||
PROFILER_APP_NAME=My super app | ||
PROFILER_APP_NAME="My super app" | ||
``` | ||
|
||
## Client configuration | ||
|
||
When integrating with Buggregator, especially if you're developing a custom client, it's essential to understand how to | ||
correctly configure the data transmission. This guide outlines various methods to designate your requests as xhprof | ||
requests | ||
|
||
### Using HTTP auth | ||
|
||
Add `profiler` to the host name, e.g. `http:https://profiler@...` | ||
|
||
### Using header | ||
|
||
Add a header `X-Buggregator-Event` with value `profiler` or just add `X-Profiler-Dump` with any value. | ||
|
||
### Special endpoint | ||
|
||
You can use special endpoint `/profiler/store` to send data to Buggregator. |