インスタンスのプロビジョニング

IBM Cloud カタログから IBM Cloud Logs サービスのインスタンスをプロビジョニングしたり、 terraform スクリプトや Resource Controller API を使ってプログラムでプロビジョニングすることができます。

IBM Cloud Logsは、IBM Cloud Object Storageと統合し、データの長期保存とメトリクスの収集を行い、IBM Cloud Event Notificationsと統合し、アラートをトリガーします。 サービス間の認可は、アカウント内の認可をサービスするためにIAMサービスを構成することによって行われる。

データ・バケットやメトリクス・バケットなしでCloud Logsを実行できます。 しかし、異なるコストで異なるデータ・パイプラインを通してデータを管理するTCOオプティマイザーのような機能や、長期的なデータ・クエリ、メトリクス関連の機能は利用できない。

プロビジョンされたインスタンスごとに制限があります。 詳しくは、 インスタンスごとの制限 を参照してください。

IBM Cloud Logs インスタンスをプロビジョニングする際の命名要件

IBM Cloud Logs インスタンスをプロビジョニングする場合、サービスインスタンス名の長さは1～256文字に制限され、以下の文字のみを含めることができます：

  • 手紙 (A-Z, a-z)
  • 数字 (0-9)
  • 期間 (.)
  • アンダースコア (_)
  • ハイペン (-)
  • コロン (:)
  • スペース ( )

「プログラム識別情報」ダッシュボードによるインスタンスのプロビジョニング

IBM Cloud の「プログラム識別情報」ダッシュボードからインスタンスをプロビジョンするには、以下の手順を実行します。

  1. IBM Cloud アカウントにログインします。

    ログインすると、IBM Cloud UI が開きます。

  2. メニューアイコン ナビゲーションメニューアイコン > Observabilityをクリックして、 Observability ダッシュボードにアクセスします。

  3. 「ロギング」 > 「インスタンス」 をクリックします。 IBM Cloud Logs インスタンスを表示するには、 「クラウド・ログ」 タブをクリックする必要がある場合があります。

  4. 「作成」 をクリックします。

  5. インスタンスに必要なサービスを選択します。

  6. インスタンスをプロビジョンすることを計画しているロケーションを選択します。

  7. サービス・インスタンスの名前を入力します。

  8. リソース・グループを選択します。

    デフォルトでは、default リソース・グループが設定されています。

    注: リソース・グループを選択できない場合、インスタンスをプロビジョンするリソース・グループでの編集許可があることを確認してください。

  9. Standard サービスプランを選択します。

    デフォルトでは、スタンダードプランが設定されています。

    サービス・プランについて詳しくは、 サービス・プランと料金 を参照してください。

  10. リテンション・プランを選択する。 有効な値は 7 days, 14 days, 30 days, 60 days または 90 days です。

  11. 「作成」 をクリックします。

インスタンスをプロビジョニングすると、UIが開きます。

カタログによるインスタンスのプロビジョニング

IBM Cloud Logs カタログによって IBM Cloud のインスタンスをプロビジョンするには、以下の手順を実行します。

  1. IBM Cloud アカウントにログインします。

    ログインすると、IBM Cloud UI が開きます。

  2. **「カタログ」**をクリックします。 IBM Cloud で使用可能なサービスのリストが開きます。

  3. 表示されるサービスのリストをフィルタリングするには、**「ロギングとモニタリング」**カテゴリーを選択します。

  4. **「IBM Cloud Logs」**タイルをクリックします。

  5. インスタンスをプロビジョンすることを計画しているロケーションを選択します。

  6. サービス・インスタンスの名前を入力します。

  7. リソース・グループを選択します。

    デフォルトでは、**「デフォルト」**リソース・グループが設定されています。

    注: リソース・グループを選択できない場合、インスタンスをプロビジョンするリソース・グループでの編集許可があることを確認してください。

  8. Standard サービスプランを選択します。

    デフォルトでは標準プランが設定されている。 サービス・プランについて詳しくは、 サービス・プランと料金 を参照してください。

  9. リテンション・プランを選択する。 有効な値は 7 days, 14 days, 30 days, 60 days または 90 days です。

  10. 「作成」 をクリックします。

インスタンスをプロビジョニングすると、UIが開きます。

CLI によるインスタンスのプロビジョニング

コマンド・ラインによって IBM Cloud Logs のインスタンスをプロビジョンするには、以下の手順を実行します。

  1. [前提条件] IBM Cloud CLI のインストール。

    詳しくは、『IBM CloudCLI のインストール』を参照してください。

    CLI がインストールされている場合は、次のステップに進みます。

  2. インスタンスをプロビジョンしたい、IBM Cloud のリージョンにログインします。 次のコマンドを実行します。 ibmcloud login

  3. インスタンスをプロビジョンするリソース・グループを設定します。 次のコマンドを実行します。 ibmcloud target

    デフォルトでは、default リソース・グループが設定されています。

  4. インスタンスを作成します。 次の ibmcloud resource service-instance-create コマンドを実行します。

    ibmcloud resource service-instance-create NAME logs SERVICE_PLAN_NAME LOCATION -p '{"private_endpoints_only": PRIVATE_ENDPOINT}'

    説明

    NAME は、インスタンスの名前です。

    SERVICE_PLAN_NAME はプランのタイプです。 有効な値は標準。

    LOCATION はロギング・インスタンスが作成されるリージョンです。 IBM Cloud Logs サービス用に選択可能なロケーションの最新リストを入手するには、ロケーションを参照してください。

    • PRIVATE_ENDPOINTは、trueまたはfalseのいずれかです。 インスタンスへのアクセスにtrueのみプライベート・エンドポイント 使用できる場合。

      インスタンスのプロビジョニング時に特に指定しない限り、デフォルトでは、パブリック・エンドポイントとプライベート・エンドポイントの両方からインスタンスにアクセスできます。

    たとえば、プライベート・エンドポイントからのみアクセスできる標準プランでインスタンスをプロビジョニングするには、次のコマンドを実行します：

    ibmcloud resource service-instance-create my-instance logs standard us-south -p '{"private_endpoints_only": true}'

次のステップ

IBM Cloud Logs データの長期保存とメトリクスの収集には IBM Cloud Object Storage、アラートのトリガーには IBM Cloud Event Notifications。 サービス間の認可は、 アカウント IAM service to service ( S2S ) の認可を設定することで行われる。

インスタンスをプロビジョニングしたら、以下の手順を実行します：

  1. データバケットとメトリクスバケットをアタッチして、長期保存用と検索用のデータを保存する。 詳しくは、バケットの設定 を参照してください。

  2. IBM Cloud Event Notifications インスタンスへのアウトバウンドインテグレーションを設定し、Eメールやslackなどお好みの宛先に通知を送信します。 詳細については、 IBM Cloud Logs と IBM Cloud Event Notifications を接続するためのアウトバウンド統合の設定 および 通知チャネルでの作業を 参照してください。

  3. 1つ以上のログソースを設定する。 以下のいずれかのオプションを選択します。

    • ロギングエージェントを設定する。 このエージェントは、ログの収集とインスタンスへの転送を行います。 詳細については、 ロギング・エージェントを 参照してください。

    • IBM Cloud、 グローバル および ロケーションベースの イベントデータの両方の監査イベントを IBM Cloud Logs インスタンスにルーティングするように IBM Cloud Activity Tracker Event Routing を設定します。 詳しくは、IBM Cloud Activity Tracker Event Routing の紹介を参照してください。

    • IBM Cloud アカウント IBM Cloud Logs インスタンスにプラットフォームログをルーティングするように IBM® Cloud Logs Routing を設定する。 詳しくは、IBM® Cloud Logs Routing 概説を参照してください。