c9ea3bd4a7
* Only sampled spans should be exported https://github.com/open-telemetry/opentelemetry-php/issues/140 * BatchSpanProcessor should flush by time limit even if Span is not sampled |
||
|---|---|---|
| .github | ||
| .phan | ||
| Context | ||
| api/Trace | ||
| contrib | ||
| docker | ||
| examples | ||
| sdk | ||
| tests | ||
| .dockerignore | ||
| .gitignore | ||
| .php_cs | ||
| .phpcs.xml | ||
| .scrutinizer.yml | ||
| CODEOWNERS | ||
| CONTRIBUTING.md | ||
| LICENSE | ||
| Makefile | ||
| README.md | ||
| code-of-conduct.md | ||
| composer.json | ||
| docker-compose.yaml | ||
| phpunit.xml.dist | ||
README.md
OpenTelemetry php library
Communication
Most of our communication is done on gitter.im in the opentelemetry-php channel.
Our meetings are held weekly on zoom on Wednesdays at 10:30am PST / 1:30pm EST.
A Google calendar invite with the included zoom link can be found here
Our open issues can all be found in the github issues tab. Feel free to reach out in gitter if you have any additional questions about these issues; we are always happy to talk through implementation details.
Installation
The recommended way to install the library is through Composer:
1.) You'll need to add a
"minimum-stability": "dev"
To your project's composer.json file, as this utility has not reached a stable release status quite yet.
2.) Install the dependency with composer:
$ composer require open-telemetry/opentelemetry
Development
We use docker and docker-compose to perform a lot of our static analysis and testing.
If you're planning to develop for this library, it'll help to install docker engine and docker-compose.
You can find installation instructions for these packages can be found here, under the Docker Engine and Docker Compose submenus respectively.
Styling
We use PHP-CS-Fixer for our code linting and standards fixer. The associated configuration for this standards fixer can be found in the root of the repository here
To ensure that your code is stylish, you can execute make style from your bash compatible shell. This process will print out the fixes that it is making to your associated files. Usually this process is performed as part of a code checkin. This process runs during CI and is a required check. Code that doesn't follow this style pattern will emit a failure in CI.
Static Analysis
We use Phan for static analysis. Currently our phan configuration is just a standard default analysis configuration. You can use our phan docker wrapper to easily perform static analysis on your changes.
Execute make phan from your bash compatible shell.
This process will return 0 on success.
Usually this process is performed as part of a code checkin. This process runs during CI and is a required check. Code that doesn't match the standards that we have defined in our phan config will emit a failure in CI.
Testing
To make sure the tests in this repo work as you expect, you can use the included docker test wrapper.
Execute make test from your bash compatible shell. This will output the test output as well as a test coverage analysis. Code that doesn't pass our currently defined tests will emit a failure in CI
Examples
You can use the examples/AlwaysSampleTraceExample.php file to test out the reference implementation we have. This example perfoms a sample trace with a grouping of 5 spans and POSTs the result to a local zipkin instance.
The PHP should execute by itself (if you have a zipkin instance running on localhost), but if you'd like a no-fuss way to test this out with docker and docker-compose, you can perform the following simple steps:
1.) Install the necessary dependencies by running make install. This will install the composer dependencies and store them in /vendor
2.) Execute the example trace using make examples.
Exported spans can be seen in zipkin at http://127.0.0.1:9411
Exported spans can also be seen in jaeger at http://127.0.0.1:16686