プロジェクトは、Simple Log Service (SLS) におけるリソース管理の基本単位です。リソース分離、アクセス制御、および SLS リソースへのエントリーポイントを提供します。
プロジェクト
Simple Log Service (SLS) では、プロジェクトはリソースの分離とアクセス管理における基本単位です。
異なるプロジェクトを使用すると、以下のメリットがあります。
異なる LogStore または MetricStore の整理と管理：実際には、さまざまなプロジェクト、製品、または環境からログを収集して保存するために SLS を使用する必要がある場合があります。これらのログを異なるプロジェクトで管理することで、ログの利用、エクスポート、または分析を簡素化できます。
アクセスコントロールの分離：RAM ユーザーに、特定のプロジェクトで操作を実行する権限を付与できます。
リソースアクセスのエントリポイントの提供：SLS は、各プロジェクトに独立したサービスエンドポイントを提供します。このエンドポイントを使用して、ネットワーク経由でログの書き込み、読み取り、管理を行うことができます。エンドポイントの詳細については、「サービスエンドポイント」をご参照ください。
プロジェクトの作成
特定のアプリケーションに関連するすべてのログとログソースを管理するために、プロジェクトを作成できます。
コンソール
Simple Log Service (SLS) コンソールにサインインします。「プロジェクト」セクションで、プロジェクトの作成 をクリックします。
プロジェクトを設定します：
リージョン： ログソースの場所に基づいて Alibaba Cloud のリージョンを選択します。プロジェクトの作成後にリージョンを変更することはできません。また、SLS はクロスリージョンのプロジェクトの移行をサポートしていません。ECS インスタンスからログを収集する場合は、ECS インスタンスと同じリージョンを選択することを推奨します。この設定により、Alibaba Cloud の内部ネットワーク経由でログを収集できるため、パフォーマンスが向上します。
プロジェクト名： プロジェクト名はグローバルに一意である必要があり、作成後に変更することはできません。
その他の設定はデフォルト値のままにします。
API
CreateProject API
エラー ProjectAlreadyExist が返され、コンソールにプロジェクトが表示されない場合
原因：プロジェクト名はグローバルに一意である必要があります。アカウント配下にプロジェクトが表示されない場合は、別の Alibaba Cloud アカウントがそのプロジェクト名を所有している可能性があります。
対処法：Alibaba Cloud のリソース分離の仕組みにより、別のアカウント配下のプロジェクトを表示または削除することはできません。別の一意なプロジェクト名を指定して、再度作成してください。
プロジェクトソースの特定
Simple Log Service (SLS) は、他の Alibaba Cloud サービスと統合されると、プロジェクトを自動的に作成することがあります。多数のプロジェクトがある場合、その作成元を追跡し、保存されているデータを理解し、関連するコストを確認したいことがあります。
Simple Log Service (SLS) コンソールにサインインし、プロジェクトリストで対象のプロジェクトを見つけます。
プロジェクトのソースを特定するには、サービスアイコンまたは説明列を確認します：
プロジェクト名の前にアイコンが表示されている場合は、アイコンにカーソルを合わせると、関連するクラウドサービスの名前が表示されます。
説明 列にテキストが記載されている場合、それはプロジェクトの作成元を示します。
上記のいずれにも当てはまらない場合、プロジェクトはユーザーが手動で作成したものです。
自動的に作成されるプロジェクトのタイプ
システムまたは他の Alibaba Cloud サービスによって、特定の機能をサポートするために自動的に作成されるプロジェクトがあります。これらのプロジェクトは通常、固定の命名規則に従い、専用の目的を持っています。一般的なタイプは次のとおりです：
Cloud Monitor Service (CMS) メタデータプロジェクト：CMS 2.0 は、
aliyun-metadata-{user-ID}-{region-ID}という形式の名前でこれらのプロジェクトを自動的に作成し、CMS メタデータを保存します。これらのプロジェクトは無料です。削除する必要がある場合、コンソール操作が制限されることがあるため、CloudShell でコマンドを実行することによってのみ削除できます。他のクラウドサービスによって自動的に作成されるプロジェクト：
Application Real-Time Monitoring Service (ARMS) ：トレースデータを保存するためにプロジェクトを自動的に作成します。
ActionTrail ：操作ログを保存するためにプロジェクトを自動的に作成します。
ログ監査サービス：集中ログ管理のために、リージョン別または一元化されたプロジェクトを自動的に作成します。
プロジェクトに関連付けられているクラウドサービスを特定した後、プロジェクトに保存されているデータなどの詳細については、「Alibaba Cloud サービスからのログ収集」をご参照ください。
プロジェクトが使用中かどうかの判断：Cloud Firewall や Web Application Firewall (WAF) など、関連するクラウドサービスがまだ実行中かどうかを確認します。プロジェクトの基本情報にデータがなく、Logtail 構成もない場合、現在使用されていない可能性があります。ただし、削除する前に、対応するクラウドサービスが SLS を必要としなくなったことを常に確認してください。関連するクラウドサービスがまだ使用中の場合、サービスが自動的に作成したプロジェクトを削除することは推奨しません。
プロジェクトにバインドまたは使用されているクラウドサービスの特定
Simple Log Service (SLS) は現在、どのクラウドサービスが特定のプロジェクトにバインドされているかを直接照会する公開メタデータ操作を提供していません。代わりに、次の間接的な方法を使用します。
プロジェクト名による専用ソースの特定：一部のクラウドサービスは、固定の命名規則に従うプロジェクトを作成します。確認されている命名規則には次のものがあります：
waf-project-{user-ID}-*、sas-log-{user-ID}-*、およびaegis-log-{user-ID}-*：Web Application Firewall (WAF) や Security Center などのサービス専用です。SLS コンソールでこのタイプのプロジェクトを削除しようとすると、操作はブロックされ、対応するクラウドサービスのコンソールで操作を実行するように促されます。このプロンプト自体が、プロジェクトがまだクラウドサービスによって使用されていることを示します。log-service-{user-ID}-{region}：サービスログを有効にすると、システムが作成します。このプロジェクトは、SLS がユーザーのために書き込むサービスログと運用ログのデータを保存するために使用されます。このセクションの 自動的に作成されるプロジェクトのタイプ リストとプロジェクトを比較することもできます。これには、Cloud Monitor Service (CMS) メタデータプロジェクト (
aliyun-metadata-{user-ID}-{region-ID})、Application Real-Time Monitoring Service (ARMS)、ActionTrail (操作監査)、およびログ監査サービス (ログ監査) が含まれています。
プロジェクト内のリソースからソースサービスを特定する：対象のプロジェクトを開き、そこに含まれるリソースを確認します。リソース名と説明を使用して、どのサービスがそれらに書き込んでいるかを判断します。クラウドサービスが SLS と統合されると、通常、サービス固有の識別子を持つ Logstore が作成され、その目的が説明されます。次のリソースを確認してください：
Logstore、MetricStore、および eventstore のリスト：まだデータを受信しているストアは、対応するサービスがまだプロジェクトを使用していることを意味します。ストアを開いてクエリを実行し、新しいデータが到着するかどうかを確認します。
Logtail 構成とマシングループのリスト：Logtail 構成が適用されている場合、それは関連するインスタンスに対して Logtail データコレクターによるログ収集がまだ実行中であることを意味します。
コンシューマーグループ、データ変換ジョブ、およびデータ転送ジョブのリスト：実行中のデータ変換ジョブ、データ転送ジョブ、またはコンシューマーグループは、ダウンストリームサービスがまだデータを消費していることを意味します。
保存済み検索とアラートのリスト：ログ分析に使用される保存済み検索、またはサイレンス状態でないアラートルールは、プロジェクトがまだ監視されていることを示します。データ分類とカスタムドメイン設定が構成されている場合も、同様の方法で確認します。
RAM コンソールでサービスリンクロール (SLR) の承認を確認する：RAM コンソールにサインインし、サービスリンクロールのリストを確認して、クラウドサービスが SLS にデータを書き込むためにサービスリンクロールを作成したかどうかを判断します。関連するサービスリンクロールが存在し、対応するクラウドサービスがまだ実行中の場合、そのサービスはまだ SLS にデータを書き込んでいる可能性があります。
これらはすべて間接的な方法であり、すべてのバインディングを明らかにすることを保証するものではありません。プロジェクトを削除する前に、関連するクラウドサービスが SLS を必要としなくなったことを常に確認してください。プロジェクトの所有者を特定できない場合は、プロジェクトを保持するか、サポートのためにチケットを送信することを推奨します。
プロジェクトのリソース使用状況と課金を分析するには、「CloudLens for SLS を使用したリソース使用状況の分析」をご参照ください。
プロジェクトリストにプロジェクトが表示されない ：Simple Log Service コンソールのプロジェクトリストにプロジェクトが表示されない場合、そのプロジェクトは作成されていないか、削除されたか、または Application Real-Time Monitoring Service (ARMS) などの関連するクラウドサービスによって自動的に作成された可能性があります。問題をトラブルシューティングするには、次の手順を実行します：
プロジェクトリストの上にある検索ボックスにプロジェクト名を入力して、プロジェクトが Alibaba Cloud アカウントに存在するかどうかを確認します。検索で結果が返されない場合、プロジェクトは現在の Alibaba Cloud アカウントには存在しません。
プロジェクトがごみ箱にあるかどうかを確認します。[プロジェクト概要] ページで、[基本情報] > [プロジェクトのごみ箱] を選択して、ごみ箱の状態を確認します。ごみ箱が有効で、プロジェクトがリストされている場合は、ごみ箱からプロジェクトを復元できます。
プロジェクトが ARMS などの関連クラウドサービスによって自動的に作成された場合は、そのクラウドサービスのコンソールに移動し、データ収集機能が有効になっているかどうかを確認します。たとえば、ARMS コンソールで、[システム設定] > [クラスター設定] を選択します。表示されるページで、[ARMS アプリケーション収集] または [OpenTelemetry アプリケーション収集] の下にある [収集タスク] スイッチを見つけて、一度オフにしてから再度オンにし、トレースデータ収集を再有効化します。収集機能が再有効化されると、関連するプロジェクトがプロジェクトリストに再表示されます。
説明スイッチをオフにすると、サーバーはサーバー側プローブによって報告されたデータを受け入れなくなります。
プロジェクトの削除保護の有効化
重要なデータを含むプロジェクトについては、誤削除を防ぐためにごみ箱機能を有効にすることを推奨します。有効にすると、削除されたプロジェクトはごみ箱に移動され、非アクティブになり、読み取りや書き込みができなくなります。必要に応じて、ごみ箱からプロジェクトを迅速に復元できます。ごみ箱内のプロジェクトについては、データストレージに対してのみ課金されます。
デフォルトでは、プロジェクトはごみ箱に 7 日間保持されます。この期間が経過すると、システムは自動的にプロジェクトを削除します。
コンソール
ごみ箱機能の有効化
Simple Log Service (SLS) コンソールにサインインします。[プロジェクト] セクションで、対象のプロジェクトをクリックします。
「プロジェクト概要」ページの「基本情報」セクションで、「プロジェクトのごみ箱」を見つけ、有効になっていない場合は 有効化 をクリックします。
API
UpdateProject オペレーションで recycleBinEnabled パラメーターを設定します。
プロジェクトの削除と復元
プロジェクトを削除すると、LogStore、MetricStore、または EventStore のデータ損失が生じる可能性があります。続行する前に、データが不要になったこと、またはバックアップ済みであることを確認してください。
プロジェクトを削除した日は、ストレージなどのリソースに対して引き続き課金されます。課金は翌日に停止します。つまり、プロジェクトを削除してから 3 日目には、Simple Log Service (SLS) からの請求書は届きません。
コンソール
削除前のクリーンアップ
関連付けられたリソースがないこと：
Elastic Compute Service (ECS)、ストレージ、セキュリティ、データベースなどのさまざまな Alibaba Cloud サービスのログ分析を有効にすると、SLS は対応するプロジェクトと LogStore をコンソールに自動的に作成します。クラウドサービスからのログが不要になった場合は、そのサービスのコンソールでログ分析機能を無効にする必要があります。プロジェクトが他の Alibaba Cloud サービスと関連付けられていないことを確認してください。
課金上の依存関係がないこと：プロジェクトがストレージパッケージやリザーブドキャパシティなどの有料プランと関連付けられている場合は、まずリソースを解約またはリリースする必要があります。
手順
重要なデータのバックアップ (オプション)
LogStore データのバックアップ：プロジェクトに保持する必要があるログデータが含まれている場合は、SLS の「ログのダウンロード」機能を使用して、事前にエクスポートしてください。
構成のバックアップ：プロジェクト名、ストレージ容量、アクセスコントロールポリシーなどの重要な設定を記録して、削除後の情報損失を防いでください。
プロジェクトの削除
プロジェクト一覧で、削除するプロジェクトを見つけ、操作列の削除をクリックします。
プロジェクトの削除 パネルで、プロジェクト名を入力し、削除理由を選択してから、OK をクリックします。
警告プロジェクトが削除されると、すべてのログデータと構成情報が完全に削除され、復元できなくなります。データ損失を防ぐため、プロジェクトを削除する前に操作内容を慎重に確認してください。
操作の確認：プロンプトを読み、確認のため、再度プロジェクト名を入力します。
プロジェクトでごみ箱機能が有効になっている場合、削除されたプロジェクトはプロジェクトリストの ごみ箱のプロジェクト タブで確認できます。デフォルトでは、プロジェクトは 7 日間ごみ箱に保持され、その期間中に復元または完全に削除できます。
削除ステータスの確認：
削除は非同期オペレーションです。削除リクエストを送信すると、システムはバックグラウンドでプロジェクトを徐々にクリーンアップします。同じプロジェクトを再度削除しようとして「プロジェクトが存在しません」というメッセージが表示された場合、通常はプロジェクトが正常に削除されたことを意味します。
SLS コンソールに移動し、対象のプロジェクトがプロジェクトリストから消えているかどうかを確認します。リストが空の場合、そのリージョンのすべてのプロジェクトリソースがクリアされています。
ごみ箱を有効にしている場合は、ごみ箱のプロジェクト リストも確認して、プロジェクトが完全に削除されたか、復元されたかを確認してください。
削除直後に同じ名前でプロジェクトを再作成すると
Project does not existエラーが発生するか、リージョンが正しく表示されない場合はどうすればよいですか？症状：プロジェクトを削除した直後に同じ名前で再作成すると、次のいずれかの問題が発生する可能性があります。
コンソールのプロジェクトリストに新しいプロジェクトが表示されない。
プロジェクトにアクセスまたは操作しようとすると、
Project does not existエラーが返される。プロジェクトのリージョンに、削除前に使用されていたリージョンが表示される。
Logtail が収集エラーを報告する。
Logstore の作成が失敗する。
このシナリオと、削除が成功した場合との違いに注意してください。同じプロジェクトを再度削除しようとして
Project does not existメッセージが返された場合は、通常、プロジェクトは正常に削除されています。ここで説明するシナリオでは、同じ名前で再作成したプロジェクトにアクセスまたは操作しようとしたときにエラーが返されます。これは、メタデータのクリーンアップが完了していないことを示しています。原因：プロジェクトの削除は非同期オペレーションです。システムは、バックグラウンドでプロジェクトのメタデータを徐々にクリーンアップするのに時間が必要です。クリーンアップが完了する前に同じ名前でプロジェクトを再作成すると、古いメタデータと新しいメタデータが短期間共存する可能性があり、上記の不整合が発生します。
解決策：推奨される順序で次の方法を試してください。
新しい名前でプロジェクトを再作成する (推奨)：これは最も迅速なアプローチであり、バックグラウンドクリーンアップの進行状況に影響されません。プロジェクト名は作成後に変更できないため、新しい名前を使用することを推奨します。
同じ名前を再利用する必要がある場合は、バックグラウンドクリーンアップが完了するまで待ってからプロジェクトを再作成する：後で作成またはアクセス操作を再試行してください。数回再試行しても操作が失敗する場合は、チケットを起票してプロジェクトのクリーンアップステータスを確認してください。
コンソールページを更新してリソースステータスを確認する：リストやリージョンが正しく表示されないのは、単にページキャッシュが原因の場合があります。Simple Log Service コンソールを更新し、プロジェクトリストを再度確認して、リソースの実際のステータスを確認してください。
API
リソースクォータの管理
リソースクォータが不十分な場合、ニーズに応じて、ログストア、シャード、Logtail 設定、マシン グループの最大数をはじめとする、プロジェクトのさまざまなクォータメトリックを調整できます。
1 つの Alibaba Cloud アカウントで最大 150 のプロジェクトを作成できます。より高い上限が必要な場合は、チケットを送信してください。
コンソール
Simple Log Service (SLS) コンソールにログインします。[プロジェクト] セクションで、対象のプロジェクトをクリックします。
プロジェクト概要ページで、[基本情報] セクションに移動し、[リソースクォータ] を見つけて 管理 をクリックします。リソースのクォータ パネルで、対象リソースのクォータを調整し、保存 をクリックします。変更が有効になるまで約 1 時間かかります。
リージョン間のログ転送の高速化
中国本土以外のリージョンから中国本土内のリージョンにログを書き込む場合など、長距離のログ転送では、転送アクセラレーション機能を有効にできます。この機能は、全世界に分散されたデータセンターのネットワークを使用して、インテリジェントルーティングを通じてユーザーリクエストを最寄りのアクセスポイントにルーティングします。最適化されたネットワークとプロトコルにより、アクセス速度を大幅に向上させます。転送アクセラレーションには、転送されたデータ量に基づいて課金されます。
コンソール
転送アクセラレーションの有効化
Simple Log Service (SLS) コンソールにサインインします。[プロジェクト] セクションで、対象のプロジェクトをクリックします。
プロジェクトの概要ページで、[エンドポイント] セクションに移動し、[アクセラレーションエンドポイント] を見つけて 有効化 をクリックします。ダイアログボックスのメッセージを読み、Modify をクリックします。
転送アクセラレーションを有効にすると、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"); /** * Simple Log Service のサービスエンドポイント。アクセラレーションエンドポイントを使用します。 */ String endpoint = "log-global.aliyuncs.com"; /** * Simple Log Service クライアントを作成します。 */ static Client client = new Client(endpoint, accessId, accessKey);
アクセラレーションドメインのアクセス検証手順
アクセラレーションドメインのネットワーク到達性を手動で検証する場合は、完全なドメイン形式の <projectname>.log-global.aliyuncs.com を使用してください。 <projectname> は、実際のプロジェクト名に置き換えてください。
LoongCollector エージェントと SLS SDK はどちらも、リクエストを開始する際にプロジェクト名を自動的に先頭に追加します。したがって、設定ファイルに <projectname> プレフィックスを手動で追加する必要はありません。
リソースのグループ化
プロジェクトをグループ化する必要がある場合は、タグまたはリソースグループを使用して分類できます。プロジェクトレベルの管理にはタグを使用し、Alibaba Cloud アカウントレベルの管理にはリソースグループを使用します。
リソースグループの設定
プロジェクトは、1 つのリソースグループにのみ所属できます。
コンソール
Simple Log Service (SLS) コンソールにサインインします。[プロジェクト] セクションで、対象のプロジェクトをクリックします。
プロジェクト概要ページの [リソースグループの詳細] セクションで、リソースグループ ID にカーソルを合わせ、[変更] をクリックし、リソースグループを選択します。
API
タグの設定
コンソール
SLS コンソールにサインインします。[プロジェクト] セクションで、対象のプロジェクトをクリックします。
プロジェクト概要ページの [タグ] セクションで、[編集] をクリックし、[タグの編集] パネルでタグを設定します。
API
エンドポイントの表示とカスタムドメインの設定
エンドポイント情報を表示したり、パブリックエンドポイントをカスタムドメインに置き換えたりできます。設定完了後、対応するドメインを API コールのエンドポイントとして使用できます。
コンソール
Simple Log Service (SLS) コンソールにサインインします。[プロジェクト] セクションで、対象のプロジェクトをクリックします。
プロジェクトの概要ページで、[エンドポイント] セクションに移動し、現在のプロジェクトのエンドポイント情報を表示します。
プロジェクトの概要ページの [基本情報] セクションで、[カスタムドメイン] にカーソルを合わせ、[セット] をクリックします。カスタムエンドポイントの設定 パネルでドメイン名を設定し、バインド をクリックします。
Alibaba Cloud DNS コンソールで、CNAME レコードを追加してドメインのバインドを有効にします。[レコード値] を、プロジェクト概要ページの [エンドポイント] セクションに記載されている パブリックエンドポイント に設定します。詳細な手順については、「CNAME レコード」をご参照ください。
API
カスタムドメインへの SSL 証明書のバインド
現在の動作：SLS コンソールでは、カスタムドメインに SSL 証明書を直接アップロードしたり、バインドしたりすることはできません。
解決策：
オプション 1 (推奨します)：Alibaba Cloud CDN を使用します。Alibaba Cloud CDN を使用して SLS エンドポイントを高速化し、CDN コンソールで SSL 証明書をバインドして、CDN 経由で SLS にアクセスします。
オプション 2 (デフォルト)：デフォルトの SLS エンドポイントを使用します。SLS のデフォルトエンドポイントには SSL 証明書が組み込まれており、HTTPS に対応しています。ほとんどの場合、追加の設定なしで使用できます。
プロジェクトの監視と維持
サービスログ機能を使用すると、プロジェクト内のリソース操作ログ (作成、変更、更新、削除) やタスク実行ログ (スケジュールされた SQL、データインポート、データ転送) を取得できます。また、LogStore からコンシューマーグループの消費レイテンシーログ、および Logtail からのエラー、ハートビート、統計ログも取得できます。
コンソール
Simple Log Service (SLS) コンソールにサインインします。[プロジェクト] セクションで、対象のプロジェクトをクリックします。
プロジェクトの [サービスログ] ページで、詳細ログを有効化 をクリックします。[サービスログ設定の変更] パネルで、有効にするサービスログと、保存先のプロジェクトを選択します。
詳細ログ：完全な操作ログです。従量課金制の機能です。
重要ログ：メータリングログ、コンシューマーグループのレイテンシーログ、Logtail ハートビートログです。この機能は無料です。
タスク操作ログ：データインポートタスク、スケジュールされた SQL ジョブ、データ転送タスクの操作ログです。この機能は無料です。
ログの保存先：既存のプロジェクトを選択するか、システムに新しいプロジェクトを自動的に作成させます。
制限と互換性
一括削除の制限：SLS では現在、プロジェクトまたはログストアを一括削除するためのツールは提供されていません。手動で1つずつ削除する必要があります。
モバイルアクセス：モバイルブラウザからSLS コンソールにアクセスし、サインインして、プロジェクトの作成、変更、削除などの管理を行うことができます。
作成後にプロジェクトが表示されない場合：新しく作成したプロジェクトが一覧に表示されない場合は、正しいリージョンが選択されていることを確認し、ページを更新してください。
詳細情報
プロジェクトに異なる種類のデータを保存するには、種類の異なる複数のログストアを作成する必要があります。詳細については、「ログストアの管理」をご参照ください。