CSDKAPIの使用ガイド

NewRelicのCSDKは、アプリケーションとマイクロサービスを監視して、パフォーマンスの問題を特定して解決するのに役立ちます。 Cアプリケーションは、コンパイルされたネイティブバイナリファイルから実行されます。トランザクションを監視するには、NewRelicメソッドを追加してコードを手動でインストルメント化する必要があります。

このガイドは、使用する方法を決定するのに役立ちます。メソッドのコード、必要なパラメーター、および例は、 GitHubにあるNewRelicのCSDKドキュメントにあります。

カスタマイズがスレッドセーフであることを確認してください

C SDKはマルチスレッドアプリケーションのインストルメンテーションをサポートしていますが、複数のスレッドをインストルメントする前に初期化する必要があります。次の関数のいずれかを呼び出すときは、他のC SDK関数が呼び出される前に、それらがメインスレッドで呼び出されていることを確認してください。

• newrelic_configure_log
• newrelic_init

トランザクションの監視

トランザクションを監視するためにコードを手動でインストルメントする前に：

1. アプリのCSDKの互換性と要件を確認してください。
2. 最新バージョンのCSDKライブラリを使用していることを確認し、必要に応じて更新します。

セグメントを使用した時間固有の方法

トランザクションがNewRelicにすでに表示されているが、そのトランザクション中に呼び出された特定のメソッドに関する十分なデータがない場合は、セグメントをインストルメント化できます。たとえば、複雑なロジックを持つメソッドの時間を計測する場合は、トランザクション内のメソッドごとにセグメントを作成できます。

既存のトランザクション内でメソッドをインストルメント化するには、次のいずれかのセグメントを作成します。

• 外部サービス
• 関数またはその他の任意のコードブロック（カスタムセグメントを使用）
• データストア
• 遅いクエリトレース（SQLデータストアのみ）

newrelic_start_datastore_segment()
newrelic_start_external_segment()
newrelic_start_segment()

セグメントはアクティブなトランザクションに記録されます。アクティブなトランザクションにセグメントを追加するときは、 newrelic_start_web_transaction()またはnewrelic_start_non_web_transaction()によって返されるnewrelic_txn_t*またはトランザクションポインタにアクセスする必要があります。

トランザクションのメタデータを強化する

NewRelicがトランザクションについて報告するメタデータを管理できます。これは、トランザクションに異なるレベルの詳細が必要な場合に役立ちます。例えば：

• メトリックのグループ化の問題が発生している場合は、トランザクションのデフォルト名を変更して、トランザクションをより識別しやすくすることができます。

• 作成したい場合

  ダッシュボード

  トランザクションには、カスタム属性を追加できます。

外部サービスへの機器呼び出し

次の方法を使用して、アプリと他のアプリまたはデータベースとの接続に関するデータを収集します。

エラーを収集またはログに記録する

CSDKはエラーを自動的に検出します。 New Relicにエラーを報告する方法を変更する場合は、エラーコレクターの構成を変更してください。

アプリからカスタムデータを送信する

C SDKを使用してカスタムデータを記録するには、次のいずれかの方法を使用できます。

• カスタムイベント： New Relicでは、イベントデータは基本的なデータ型です。イベントデータは、特定の時点での単一のイベントの記録を表します。これは、特定の詳細を表示または照会するのに役立ちます。
• カスタムイベント属性：イベントに関する追加のメタデータを含めるために、キーと値のペア（カスタム属性）をカスタムイベントに追加できます。
• カスタムメトリクス：メトリクスタイムスライスデータは、New Relicが集計するデータの統計的尺度であり、UIで表示してグラフ化できます。通常、メトリックデータの保存期間はイベントデータよりも長くなります。

// txn is a newrelic_txn_t*, created via newrelic_start_web_transaction
newrelic_custom_event_t* custom_event=0;
custom_event = newrelic_create_custom_event("aTypeForYourEvent");
newrelic_record_custom_event(txn, &custom_event);

// Example custom attributes:
newrelic_custom_event_t* custom_event=0;
custom_event = newrelic_create_custom_event("aTypeForYourEvent");

newrelic_custom_event_add_attribute_int(custom_event, "keya", 42);
newrelic_custom_event_add_attribute_long(custom_event, "keyb", 84);
newrelic_custom_event_add_attribute_double(custom_event, "keyc", 42.42);
newrelic_custom_event_add_attribute_string(custom_event, "keyd", "A string");

newrelic_record_custom_event(txn, &custom_event);

カスタムデータを使用するいくつかの方法があります。これらのオプションのコードの詳細と例については、GitHubのNewRelicグローバルドキュメントを参照してください。

デスクトップブラウザのパフォーマンスを監視する

アプリケーションのデスクトップブラウザのパフォーマンスを監視するには、 コピー/貼り付け方法を使用してブラウザエージェントをインストールします。

構成設定の変更

通常、アプリケーションの構成のデフォルト設定を変更する必要はありません。ただし、必要に応じて、一部の設定を調整できます。詳細については、 CSDK構成のドキュメントを参照してください。