すべてのプロダクト
Search

このプロダクト

    Simple Log Service:CプロデューサーSDK

    ドキュメントセンター

    Simple Log Service:CプロデューサーSDK

    最終更新日:Sep 05, 2024

    このトピックでは、C Producer SDKの使用方法について説明します。

    Simple Log Service C Producerは、Cプログラミング言語でのみ記述されたログ収集エージェントです。 C Producerは、単純な環境依存のみを必要とし、低リソースを消費します。 C Producerを使用して、組み込みデバイスやスマートデバイスからログを収集できます。

    機能

    • 非同期書き込み

      • ログは非同期に書き込まれ、エージェントスレッドはブロックされません。

    • ログの集計と圧縮

      • ログは、タイムアウト期間、ログ量、およびログサイズに基づいて集計し、アップロードできます。

      • ログはLZ4アルゴリズムを使用して圧縮し、アップロードすることができます。

    • コンテキストクエリ

      • デバイスによって生成されるログは同じコンテキストにあります。 Simple log Serviceで、指定したログの前後に生成されたログを表示できます。

    • 同時送信

      • 同時にログを送信するようにスレッドプールを設定できます。

    • キャッシング

      • キャッシュの上限を指定できます。 キャッシュされたログのサイズが上限に達すると、ログはキャッシュに書き込まれなくなります。

    • カスタム識別子

      • デフォルトでは、ログはIPアドレスでアップロードされます。

      • カスタムタグとトピックを指定できます。

    メリット

    • C Producerは、高同時書き込み操作をサポートします。 1秒間に数十万のログをSimple Log Serviceに書き込むようにスレッドプールを設定できます。 詳細については、「パフォーマンステスト」をご参照ください。

    • C Producerは低リソースを消費します。1秒あたり200, 000ログを書き込むために消費されるCPUリソースは30% のみです。 Raspberry Piなどの低パフォーマンスハードウェアで1秒間に100ログが生成されても、リソースは影響を受けません。 詳細については、「パフォーマンステスト」をご参照ください。

    • C Producerはログを保存しません。 ログが生成されると、ログはSimple Log Serviceに直接送信されます。

    • コンピューティングとI/O間のロジック分離: ログは、ワーカースレッドをブロックすることなく非同期で書き込まれます。

    • 信頼できる終了: プログラムが終了すると、ログを保存する操作を呼び出します。 プログラムが再起動すると、データの信頼性を確保するためにログがSimple Log Serviceに送信されます。 詳細については、「信頼できるプログラム終了の解決策」をご参照ください。

    バージョンの選択

    デバイスのタイプと使用シナリオに基づいて、C Producerバージョンを選択できます。

    Version

    Status

    メリット

    推奨シナリオ

    master

    Available

    マスターバージョンは元のliteバージョンです。 v1 (1.0f) バージョンと比較して、マスターバージョンはより単純な依存関係を必要とし、より少ないリソースを消費し、より高いパフォーマンスを提供します。 マスターバージョンは、利用可能なすべてのバージョンの中で最高のプロデューサーパフォーマンスを提供します。 マスターバージョンの使用を推奨します。

    Linuxサーバーと組み込みLinuxデバイス。

    live

    Available

    ライブバージョンは、マスターバージョンと同じ機能を提供します。 ライブバージョンは、Windows、macOS、Android、iOSプラットフォームなど、コンパイル中のほとんどのプラットフォームをサポートします。

    マスターバージョンがサポートされていないシナリオ。

    レンガ

    Available

    レンガ版は超コンパクトです。 このバージョンは、非常に少ないバイナリとメモリリソースを消費しますが、パフォーマンスが制限される機能を提供します。 十分なリソースがないシナリオでは、ブリックバージョンを使用することをお勧めします。

    リアルタイムオペレーティングシステム (RTOS) が関与するシナリオなど、リソース使用量が10 KB未満のシナリオ。

    persistent

    Available

    マスターバージョンと比較して、永続バージョンはローカルキャッシュ機能を追加します。 この機能は、AndroidおよびiOSのモバイルバージョンのネイティブ実装で使用されます。 ローカルキャッシュ機能を有効にすると、1つのスレッドのみを使用してデータを送信できます。 Simple Log Serviceにデータを送信するときは、このバージョンを使用しないことを推奨します。

    AndroidおよびiOS用の公式SDKを使用することを推奨します。

    ダウンロードとインストール

    ソースコードをダウンロードしてC Producerをインストールする方法の詳細については、GitHubのドキュメントを参照してください。