開発者は、.NET Core、Java、Python、PHP、Node.js、C、Go、iOS、Android、C++ などの言語用のソフトウェア開発キット (SDK) を使用して、ログの収集、クエリ、分析を行うことができます。
使用上の注意
Simple Log Service SDK の実装詳細はプログラミング言語によって異なります。ただし、すべての SDK は Simple Log Service API のラッパーであり、類似の機能を提供します。これらの機能には、以下が含まれます。
Simple Log Service API 操作の統一されたラッパーを提供します。API リクエストの作成や応答の解析の詳細を処理する必要はありません。操作は異なる言語間で類似しているため、言語間の切り替えが容易です。詳細については、「API 仕様」をご参照ください。
Simple Log Service API のデジタル署名ロジックを実装します。これにより、署名の詳細を処理する必要がないため、API の使用が簡素化されます。詳細については、「リクエスト署名」をご参照ください。
ログを Protocol Buffer フォーマットでカプセル化します。ログを書き込む際に、Protocol Buffer フォーマットの特定の詳細を処理する必要はありません。詳細については、「Protocol Buffer フォーマット」をご参照ください。
Simple Log Service API で定義された圧縮メソッドを実装します。圧縮の詳細を処理する必要はありません。一部の言語の SDK は、圧縮モードでのログの書き込みをサポートしています。このモードはデフォルトで有効になっています。
統一されたエラー処理メカニズムを提供します。これにより、プログラミング言語に精通した方法でリクエストの例外を処理できます。詳細については、「エラー処理メカニズム」をご参照ください。
現在、すべての SDK は同期リクエストのみをサポートしています。
SDK リスト
次の表に、さまざまな言語向けの Simple Log Service SDK のリファレンスドキュメントと GitHub ソースコードを示します。
Simple Log Service は、プロジェクト、Logstore、シャードの数、LogItem のサイズなどの基本リソースに合理的な制限を課しています。SDK を使用する前に、制限に関するドキュメントを確認して、基本リソースの使用制限を理解してください。詳細については、「基本リソースの制限」をご参照ください。
SDK を使用してログを収集し、Simple Log Service に送信した後、ログのインデックスを構成する必要があります。これにより、ログのクエリと分析、データ変換、その他の操作を実行できます。詳細については、「インデックスの作成」および「クエリと分析のクイックガイド」をご参照ください。
SDK 言語 | リファレンスドキュメント | GitHub ソースコード |
Java | ||
.NET Core | ||
PHP | ||
Python | ||
Node.js | ||
C | ||
Go | ||
iOS | ||
Android | ||
C++ | ||
HarmonyOS |
呼び出し例
呼び出し例については、「Python SDK を使用して Simple Log Service の ListProject 操作を呼び出す」をご参照ください。
よくある質問
Simple Log Service SDK はどのような機能をサポートしていますか？
Simple Log Service SDK は、ログ収集、インデックス作成、クエリと分析、データ変換、ログ消費、ログ配信管理、アラート、スケジュールされた SQL ジョブなど、Simple Log Service のほとんどの機能をサポートしています。SDK のデバッグ中にサポートされていない機能を見つけた場合は、SDK を最新バージョンにアップグレードして再試行してください。それでも機能がサポートされていない場合は、今後の SDK の更新を確認してください。
Simple Log Service SDK を使用するための基本的な手順は何ですか？
Simple Log Service SDK は、エンドツーエンドのログ管理を提供します。SDK を使用する手順は、コンソールを使用する手順と似ています。基本的な手順は次のとおりです。
Simple Log Service を有効化します。
AccessKey ペアを取得します。
プロジェクトと Logstore を作成します。
ログを収集し、Logstore に保存します。
ログのインデックスを作成します。
ログをクエリおよび分析し、結果を視覚化します。
ログデータに対して、データ変換、配信、アラートなどの操作を実行します。
Simple Log Service は、これらの操作を簡素化するためのコンソールを提供します。詳細については、「Simple Log Service クイックスタート」をご参照ください。
SDK のデバッグ中に発生する一般的なエラーを処理するにはどうすればよいですか？
Simple Log Service SDK は、エラー処理ロジックを提供します。SDK の使用時に発生する可能性のあるエラーは、次のカテゴリに分類できます。
Simple Log Service によって返される例外。このタイプの例外は Simple Log Service SDK によって処理されます。このタイプの例外の詳細については、各 API 操作の説明とエラーコードをご参照ください。エラーコードの詳細については、「エラーコード」をご参照ください。
Simple Log Service SDK を使用してリクエストを送信する際に発生するネットワーク例外。このタイプの例外には、ネットワーク切断やサーバーの応答タイムアウトが含まれます。
メモリオーバーフローなど、Simple Log Service SDK によって生成され、プラットフォームやプログラミング言語に関連する例外。
詳細については、「エラー処理」をご参照ください。
Simple Log Service SDK を使用すると、ログの収集、インデックス作成、クエリと分析、変換に関連するさまざまなエラーが発生する可能性があります。解決策については、Simple Log Service のよくある質問をご参照ください。詳細については、「よくある質問」をご参照ください。
Simple Log Service SDK の使用に制限はありますか？
Simple Log Service は、プロジェクト、Logstore、シャードの数、LogItem のサイズなどの基本リソースに合理的な制限を課しています。SDK を使用する前に、制限に関するドキュメントを確認して、基本リソースの使用制限を理解してください。詳細については、「基本リソースの制限」をご参照ください。
SDK のコード例のドキュメントはありますか？
Simple Log Service は、一般的な操作のコード例を含むドキュメントを提供しています。これらの例は、各 SDK のリファレンスドキュメントに記載されています。
Simple Log Service Java SDK:
Simple Log Service Python SDK:
さまざまな言語向けの Simple Log Service SDK:
その他のソースコードについては、「GitHub 上の Alibaba Cloud Log ソースコードライブラリ」をご参照ください。
リファレンス
Simple Log Service SDK デバッグプラットフォーム
Alibaba Cloud OpenAPI Developer Portal は、デバッグツール、SDK、サンプル、およびサポートドキュメントを提供します。OpenAPI Developer Portal を使用すると、リクエストを手動でカプセル化したり、署名操作を実行したりすることなく、Simple Log Service API 操作を迅速にデバッグできます。詳細については、「OpenAPI Developer Portal」をご参照ください。
コマンドラインインターフェイス (CLI)
Simple Log Service は、自動構成のためのコマンドラインインターフェイス (CLI) を提供します。詳細については、「コマンドラインインターフェイス (CLI)」をご参照ください。
課金
SDK、OpenAPI Developer Portal、または Simple Log Service CLI を使用すると、コンソールを使用する場合と同じ料金が発生します。詳細については、「課金の概要」をご参照ください。