Docs » Splunk Distribution of the OpenTelemetry Collector の利用開始 » Automatic discovery of apps and services » Automatic discovery for Linux » Zero-code instrumentation for back-end applications in Linux

Zero-code instrumentation for back-end applications in Linux 🔗

The Splunk Distribution of the OpenTelemetry Collector uses automatic discovery with zero-code instrumentation to automatically detect back-end applications running in your Linux environment. By deploying the Collector with zero-code instrumentation, you can monitor applications and send data to Splunk Observability Cloud without editing your application’s code or configuring files.

Zero-code instrumentation for Linux can detect and configure the following applications and language runtimes:

  • Java

  • Node.js

  • .NET

How zero-code instrumentation for Linux works 🔗

Zero-code instrumentation for Linux operates as a mode of the Splunk Distribution of the OpenTelemetry Collector. You install and activate zero-code instrumentation for the Collector by using the Linux installer script or package manager. During installation, you can specify the types of language runtimes you want the Collector to detect.

インストール後、Collector は Linux 環境で実行され、アプリケーションへのリクエストをリッスンします。Collector はアクティビティを検出すると、アプリケーションのランタイムからテレメトリデータを収集し、このデータを Splunk Application Performance Monitoring (APM) に送信します。

要件 🔗

You need the following components to use zero-code instrumentation for back-end Linux applications:

  • systemd

  • curl

  • sudo

使用言語のランタイムに固有のコンポーネントもインストールされていることを確認してください：

Java version 8 or higher and supported libraries. See Javaエージェントの互換性と要件 for more information.

はじめに 🔗

To install and use zero-code instrumentation for Linux, follow these steps:

  1. パッケージをインストールする

  2. コレクターサービスが実行されていることを確認します。

  3. Splunk APM で結果を表示する

パッケージをインストールする 🔗

Using the installer script, you can install and activate zero-code instrumentation for either all supported applications on the host via the system-wide method or only for applications running as systemd services.

Using the installer script, you can install the zero-code instrumentation package for Java and activate zero-code instrumentation for Java for either all supported Java applications on the host via the system-wide method or for only Java applications running as systemd services.

注釈

By default, zero-code instrumentation is activated for all languages (Java, Node.js, and .NET) when using the installer script. To deactivate zero-code instrumentation for other languages, add the --without-instrumentation-sdk [language] option in the installer script command.

次の例に示すように、--with-instrumentation オプションを指定してインストーラ・スクリプトを実行します。<SPLUNK_REALM> と <SPLUNK_ACCESS_TOKEN> をそれぞれ Splunk Observability Cloud レルムとトークンに置き換えてください。

curl -sSL https://dl.signalfx.com/splunk-otel-collector.sh > /tmp/splunk-otel-collector.sh && \
sudo sh /tmp/splunk-otel-collector.sh --with-instrumentation --realm <SPLUNK_REALM> -- <SPLUNK_ACCESS_TOKEN>

注釈

If you wish to collect logs for the target host, make sure Fluentd is installed and enabled in your Collector instance by specifying the --with-fluentd option.

The system-wide zero-code instrumentation method automatically adds environment variables to /etc/splunk/zeroconfig/java.conf.

インストール時にオプションの deployment.environment リソース属性を自動的に定義するには、--deployment-environment <env> オプションを指定してインストーラ・スクリプトを実行します。次の例に示すように、<env> を希望する属性値、例えば prod で置き換えます：

curl -sSL https://dl.signalfx.com/splunk-otel-collector.sh > /tmp/splunk-otel-collector.sh && \
sudo sh /tmp/splunk-otel-collector.sh --with-instrumentation --deployment-environment prod \
--realm <SPLUNK_REALM> -- <SPLUNK_ACCESS_TOKEN>

次の例のように、追加オプションを使用して、CPU とメモリ、およびメトリクスの AlwaysOn Profilingを有効にできます：

curl -sSL https://dl.signalfx.com/splunk-otel-collector.sh > /tmp/splunk-otel-collector.sh && \
sudo sh /tmp/splunk-otel-collector.sh --with-instrumentation --deployment-environment prod \
--realm <SPLUNK_REALM> -- <SPLUNK_ACCESS_TOKEN> \
--enable-profiler --enable-profiler-memory --enable-metrics

Next, ensure the service is running and restart your application. See コレクターサービスが実行されていることを確認します。 and アプリケーションを開始する.

コレクターサービスが実行されていることを確認します。 🔗

インストールに成功したら、以下のコマンドを実行し、splunk-otel-collector サービスが実行されていることを確認します：

sudo systemctl status splunk-otel-collector

サービスが起動していない場合は、以下のコマンドで起動または再起動します：

sudo systemctl restart splunk-otel-collector

サービスが開始できない場合は、/etc/otel/collector/splunk-otel-collector.conf の SPLUNK_REALM と SPLUNK_ACCESS_TOKEN が正しいことを確認します。このコマンドでサービスのログを見ることもできます：

sudo journalctl -u splunk-otel-collector

アプリケーションを開始する 🔗

For zero-code instrumentation to take effect, you must either restart the host or manually start or restart any applications on the host where you installed the package. You must restart the host or applications after installing the zero-code instrumentation package for the first time and whenever you make any changes to the configuration file.

After your applications are running, you can verify your data. See Splunk APM で結果を表示する. You can also configure instrumentation settings. See (オプション）インストルメンテーションの設定.

(オプション）インストルメンテーションの設定 🔗

You can configure the Splunk Distribution of OpenTelemetry Collector to suit your instrumentation needs. In most cases, modifying the basic configuration is enough to get started.

To learn more, see the following resources:

Update zero-code instrumentation 🔗

パッケージリポジトリを使うか、Debian や RPM パッケージを使うことで、パッケージをアップグレードできます。

インストーラ・スクリプトを使ってパッケージをインストールした場合、または Debian や RPM のパッケージリポジトリを手動で設定した場合は、プラットフォームに応じて以下のコマンドを実行してください。パッケージのアップグレードには root 権限が必要です。

以下のコマンドを実行します：

sudo apt-get update
sudo apt-get --only-upgrade splunk-otel-auto-instrumentation

You might see a prompt to keep or overwrite the configuration file(s) in /etc/splunk/zeroconfig/. If you choose to overwrite, the configuration file reverts to the default file provided by the upgraded package.

トラブルシューティング 🔗

To troubleshoot common errors that occur when instrumenting applications, see the following troubleshooting guides:

Splunk APM で結果を表示する 🔗

After activating zero-code instrumentation, ensure your data is flowing into Splunk Observability Cloud. See データがSplunk APMに取り込まれていることを確認する.

このページは 2024年11月29日 に最終更新されました。