プロジェクトは、Simple Log Service (SLS) におけるリソース管理の基本的な単位であり、リソースの隔離とアクセス制御に使用されます。
背景情報
プロジェクトには、Logstore、Metricstore、マシングループなどのリソースを含めることができ、SLS リソースにアクセスするためのエントリーポイントとして機能します。以下の理由から、異なるプロジェクトを使用して、異なるアプリケーション、プロダクト、または環境からのデータを管理します。
異なる Logstore または Metricstore の整理と管理:プロジェクトを使用して、異なるアプリケーション、プロダクト、または環境からのログを分類および管理します。これにより、データの利用、エクスポート、分析タスクが簡素化されます。
アクセス制御の隔離:Resource Access Management (RAM) ユーザーに、特定のプロジェクトに対する操作を実行する権限を付与します。
プロジェクト固有のエンドポイント:各プロジェクトには一意のエンドポイントがあり、リソースの書き込み、読み取り、管理のためのネットワークエントリーポイントとして機能します。エンドポイントの詳細については、「サービスエンドポイント」をご参照ください。
プロジェクトの作成
プロジェクトを作成して、アプリケーションのすべてのログと関連するログソースを管理します。
コンソール
Simple Log Service コンソールにログインし、[プロジェクト] セクションに移動して、[プロジェクトの作成] をクリックします。
プロジェクトを設定します。
リージョン:ログソースの場所やその他の要因に基づいて Alibaba Cloud リージョンを選択します。プロジェクトが作成されると、そのリージョンは変更できません。SLS はリージョン間のプロジェクト移行をサポートしていません。Elastic Compute Service (ECS) インスタンスからログを収集する場合は、ECS インスタンスと同じリージョンを選択します。これにより、Alibaba Cloud の内部ネットワーク経由でログを収集し、ログ収集を高速化できます。
プロジェクト名:プロジェクトの名前です。名前は Alibaba Cloud 内でグローバルに一意である必要があります。プロジェクトが作成されると、その名前は変更できません。
他のパラメーターはデフォルト値のままにします。
API
プロジェクトソースの特定
SLS は、他のクラウドサービスと関連付けられると、自動的にプロジェクトを作成することがあります。多くのプロジェクトがある場合、そのソースを追跡して、その出所、保存しているデータ、コストなどの情報を見つけることができます。
Simple Log Service コンソールにログインし、プロジェクトリストで対象のプロジェクトを見つけます。
プロジェクト名の横にあるアイコンを確認するか、[説明] 列を見てプロジェクトのソースを特定します。
プロジェクト名の前にアイコンが表示されている場合は、アイコンにカーソルを合わせます。関連するクラウドサービスの名前が表示されます。
[説明] 列に情報が含まれている場合、それはプロジェクトのソースを説明しています。
これらの条件のいずれも満たされない場合、プロジェクトは手動で作成されたものです。
プロジェクトに関連付けられているクラウドサービスを特定した後、保存されているデータなどの詳細については、「Alibaba Cloud サービスログの収集」をご参照ください。
関連するクラウドサービスがまだ使用中の場合、自動的に作成されたプロジェクトを削除しないでください。
プロジェクトのリソース使用量と課金を分析および見積もるには、「CloudLens for SLS を使用したリソース使用量の分析」をご参照ください。
プロジェクト削除保護の有効化
重要なデータを含むプロジェクトについては、誤削除を防ぐためにゴミ箱機能を有効化します。この機能が有効な場合、削除されたプロジェクトはゴミ箱に移動されます。ゴミ箱内のプロジェクトは非アクティブであり、読み取りまたは書き込み操作をサポートしません。削除されたプロジェクトが後でまだ必要だと判断した場合は、ゴミ箱から迅速に復元できます。ゴミ箱内のプロジェクトについては、データストレージ料金のみが課金されます。
プロジェクトはデフォルトで 7 日間ゴミ箱に保持され、保持期間が終了すると自動的に削除されます。
コンソール
ゴミ箱機能の有効化
Simple Log Service コンソールにログインします。[プロジェクト] セクションで、対象のプロジェクトの名前をクリックします。
[プロジェクト概要] ページの [基本情報] セクションで、[ゴミ箱] を有効にします。
API
UpdateProject 操作で `recycleBinEnabled` パラメーターを変更します。
プロジェクトリソースの削除と復元
プロジェクトを削除すると、その Logstore 内のデータは完全に削除されます。プロジェクトを削除する前に、Logstore、Metricstore、Eventstore などのリソース内のデータが不要であるか、バックアップされていることを確認してください。
プロジェクトを削除した日には、ストレージやその他のリソースに対して課金されます。課金を停止する方法の詳細については、「SLS を無効にして課金を停止するにはどうすればよいですか?」をご参照ください。SLS の課金は、プロジェクトを削除してから 3 日目に停止します。
コンソール
削除前のリソースのクリア
サービス連携なし:
エラスティックコンピューティング、ストレージ、セキュリティ、データベースなどの Alibaba Cloud サービスのログ分析機能を有効にすると、対応するプロジェクトと Logstore が SLS コンソールに自動的に作成されます。Alibaba Cloud サービスからのログが不要になった場合は、そのサービスのコンソールでログ分析機能を無効にする必要があります。プロジェクトが他の Alibaba Cloud サービスと関連付けられていないことを確認してください。
課金依存関係なし:ストレージプランやプロビジョニングされた容量など、関連する有料リソースがリリースまたはサブスクライブ解除されていることを確認してください。
プロジェクトを削除する手順
重要なデータのバックアップ (オプション)
Logstore データのバックアップ:プロジェクトに保持する必要のあるログデータが含まれている場合は、まず [ログのダウンロード] 機能を使用してデータをエクスポートする必要があります。
設定情報のバックアップ:削除後の情報損失を防ぐために、プロジェクト名、ストレージ容量、アクセス制御設定などの主要な設定を記録します。
プロジェクトの削除
プロジェクトリストで、削除したいプロジェクトを見つけ、[操作] 列の [削除] をクリックします。
[プロジェクトの削除] ダイアログボックスで、プロジェクト名を入力し、削除理由を選択して、[OK] をクリックします。
警告プロジェクトが削除されると、プロジェクト内のすべてのログデータと設定情報が削除され、復元できなくなります。データ損失を防ぐため、操作は慎重に行ってください。
プロジェクトでゴミ箱機能が有効になっている場合、プロジェクトリストの [ゴミ箱内のプロジェクト] タブで削除されたプロジェクトを見つけます。デフォルトでは、プロジェクトは 7 日間ゴミ箱に保持され、その間に復元または完全に削除できます。
API
リソースクォータの管理
リソースクォータが不十分な場合は、Logstore の最大数、シャード、Logtail 設定、マシングループなど、さまざまなプロジェクトメトリックのクォータの引き上げをリクエストします。
Alibaba Cloud アカウントで作成できるプロジェクトの最大数は 150 です。より高いクォータを要求するには、して引き上げをリクエストしてください。
コンソール
Simple Log Service コンソールにログインします。[プロジェクト] セクションで、対象のプロジェクトの名前をクリックします。
[プロジェクト概要] ページの [基本情報] セクションで、[リソースクォータ] を見つけ、[管理] をクリックします。[リソースクォータ] パネルで、目的のリソースのクォータを調整し、[保存] をクリックして申請を送信します。変更は約 1 時間で有効になります。
リージョン間ログ転送のアクセラレーション
中国本土以外のリージョンから中国本土内のリージョンへの転送など、長距離のログ転送の場合は、転送アクセラレーション機能を有効化します。この機能は、データセンターのグローバルネットワークとインテリジェントルーティングを活用して、リクエストを最寄りの SLS アクセスポイントに誘導し、最適化されたネットワークパスとプロトコルを通じて転送速度を大幅に向上させます。転送アクセラレーションは、転送されたデータ量に基づいて課金されます。
コンソール
転送アクセラレーションの有効化
Simple Log Service コンソールにログインします。[プロジェクト] セクションで、対象のプロジェクトの名前をクリックします。
[プロジェクト概要] ページの [エンドポイント] セクションで、[アクセラレーションエンドポイント] を見つけ、[有効化] をクリックします。ダイアログボックスのメッセージを読み、[変更] をクリックします。
転送アクセラレーションを有効にすると、Logtail を使用してログを収集したり、データ変換ジョブを実行したりする際の転送速度が向上します。
API
まず、PutProjectTransferAcceleration 操作を呼び出します。
この機能を使用するには、
endpointパラメーターをアクセラレーションエンドポイントに設定する必要があります。アクセラレーションエンドポイントは、HTTP および HTTPS 経由の API アクセスのみをサポートします。Kafka や gRPC などの他のプロトコルはサポートしていません。転送アクセラレーションが不要なシナリオでは、エンドポイントを使用して転送コストを削減します。/** * この例では、環境変数から AccessKey ID と AccessKey Secret を取得します。 */String accessId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"); String accessKey = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"); /** * SLS のサービスエンドポイント。アクセラレーションエンドポイントを使用します。 */String endpoint = "log-global.aliyuncs.com"; /** * SLS クライアントを作成します。 */static Client client = new Client(host, accessId, accessKey);
リソースグループの管理
プロジェクトをグループ化するには、タグまたはリソースグループを使用します。主な違いは、グループ化の範囲です。タグはプロジェクトレベルでのグループ化と管理に使用されます。リソースグループは、Alibaba Cloud アカウントレベルでリソースを管理するためのメカニズムを提供します。
リソースグループの設定
1 つのプロジェクトは、1 つのリソースグループにのみ属することができます。
コンソール
Simple Log Service コンソールにログインします。[プロジェクト] セクションで、対象のプロジェクトの名前をクリックします。
[プロジェクト概要] ページの [リソースグループ詳細] セクションで、リソースグループ ID にカーソルを合わせ、[変更] をクリックし、新しいリソースグループを選択します。
API
タグの設定
コンソール
Simple Log Service コンソールにログインします。[プロジェクト] セクションで、対象のプロジェクトの名前をクリックします。
[プロジェクト概要] ページの [タグ] セクションで、[編集] をクリックし、タグを設定します。
API
ドメイン名の表示とカスタムドメイン名の設定
ドメイン名情報を表示するか、パブリックドメイン名をカスタムドメイン名に置き換えます。カスタムドメイン名を設定した後、API 呼び出しでエンドポイントとして使用します。
コンソール
Simple Log Service コンソールにログインします。[プロジェクト] セクションで、対象のプロジェクトの名前をクリックします。
[プロジェクト概要] ページの [エンドポイント] セクションで、現在のプロジェクトのドメイン情報を表示します。
[プロジェクト概要] ページの [基本情報] セクションで、[カスタムドメイン] にカーソルを合わせ、[変更] をクリックします。[カスタムエンドポイントの指定] パネルで、ドメイン名を入力し、[バインド] をクリックします。詳細については、「ドメイン名の登録」をご参照ください。
Alibaba Cloud DNS コンソールで、CNAME レコードを作成して、カスタムドメインをパブリックエンドポイントにポイントします。[レコード値] を、SLS の [プロジェクト概要] ページに記録されている [パブリックエンドポイント] に設定します。詳細については、「CNAME レコード」をご参照ください。
API
プロジェクトリソースの監視
サービスログ機能を使用して、作成、変更、更新、削除などの操作ログを含むさまざまな種類のログを取得します。また、Scheduled SQL、データインポート、データシッピングなどのジョブのタスク実行ログ、Logstore 内のコンシューマーグループの消費レイテンシーログ、Logtail のエラー、ハートビート、統計ログも提供します。
コンソール
Simple Log Service コンソールにログインします。[プロジェクト] セクションで、対象のプロジェクトの名前をクリックします。
プロジェクトの [サービスログ] ページで、[詳細ログの有効化] をクリックします。[サービスログ設定の変更] パネルで、有効にするサービスログと対象のプロジェクトを選択します。
詳細ログ:完全な操作ログを提供します。これは従量課金機能です。
重要ログ:メータリングログ、コンシューマーグループのレイテンシーログ、Logtail のハートビートログを提供します。この機能は無料です。
ジョブ操作ログ:データインポート、Scheduled SQL、データシッピングジョブの実行ログを提供します。この機能は無料です。
ログストレージの場所:既存のプロジェクトを選択するか、SLS がこれらのログを保存するために新しいプロジェクトを自動的に作成するようにします。
関連ドキュメント
プロジェクトに異なる種類のデータを保存するには、異なる種類のストアを作成する必要があります。詳細については、「ストアの管理」をご参照ください。