# 計装ライブラリの使用

LLMS index: [llms.txt](/llms.txt)

---

アプリを開発する際、作業を加速するためにサードパーティのライブラリやフレームワークを使用することがあるでしょう。
OpenTelemetryを使用してアプリを計装する場合、使用するサードパーティのライブラリやフレームワークにトレース、ログ、メトリクスを手動で追加するために時間を費やすことを避けたいことがあります。

多くのライブラリやフレームワークはすでにOpenTelemetryをサポートしているか、OpenTelemetryの[計装](/docs/concepts/instrumentation/libraries/)を介してサポートされているため、テレメトリーを生成してオブザーバビリティバックエンドにエクスポートできます。

サードパーティのライブラリやフレームワークを使用しているアプリやサービスを計装する場合は、このページの手順に従って、ネイティブに計装されたライブラリと依存関係の計装ライブラリの使用方法を学んでください。

## ネイティブに計装されたライブラリを使用する {#use-natively-instrumented-libraries}

デフォルトでOpenTelemetryサポートが付属しているライブラリの場合、アプリにOpenTelemetry SDKを追加して設定することで、そのライブラリから発行されるトレース、メトリクス、ログを取得できます。

ライブラリによっては、計装のために追加の構成が必要な場合があります。
詳細はライブラリごとのドキュメントをご覧ください。






> [!IMPORTANT] ヘルプ募集中
>
> 現在のところ、OpenTelemetry がネイティブに統合された PHP ライブラリは把握していません。
> もしそのようなライブラリをご存知でしたら、[お知らせください][new-issue]。





[new-issue]: https://github.com/open-telemetry/opentelemetry.io/issues/new/choose



## 計装ライブラリを使用する {#use-instrumentation-libraries}

ライブラリにネイティブの OpenTelemetry サポートが含まれていない場合は、[計装ライブラリ](/docs/specs/otel/glossary/#instrumentation-library)を使用して、ライブラリまたはフレームワークのテレメトリーデータを生成できます。

OpenTelemetry PHP エクステンションには、多くの一般的な PHP フレームワーク用の計装ライブラリが含まれています。
たとえば、[Laravel 計装](https://github.com/open-telemetry/opentelemetry-php-contrib/tree/main/src/Instrumentation/Laravel)は、アプリケーションのアクティビティに基づいて[スパン](/docs/concepts/signals/traces/#spans)を自動的に作成します。

## セットアップ {#setup}

各計装ライブラリは Composer パッケージです。
インストールするには、次のコマンドを実行します。

```sh
php composer.phar install {name-of-instrumentation}:{version-number}
```

ここで `{name-of-instrumentation}` は、使用したい特定の計装の Packagist 参照名です。

計装の識別子を `OTEL_PHP_DISABLED_INSTRUMENTATIONS` 環境変数に追加することで、任意の計装を無効にできます。

## 利用可能な計装ライブラリ {#available-instrumentation-libraries}

利用可能な計装の一覧は、Packagist の [OpenTelemetry 計装ライブラリ](https://packagist.org/search/?query=open-telemetry&tags=instrumentation)を参照してください。

## 次のステップ {#next-steps}

計装ライブラリをセットアップした後は、カスタムのテレメトリーデータを収集するために[追加の計装](/docs/languages/php/instrumentation)を追加したいと思うかもしれません。

また、適切なエクスポーターを設定して、1つ以上のテレメトリーバックエンドに[テレメトリーデータをエクスポート](/docs/languages/php/exporters)することもできます。