Compute@Edge ログストリーミング: Cloud Files

Fastly の Compute@Edge サービスのリアルタイムログストリーミング機能では、ログファイルを Cloud Files に送信することができます。Rackspace によって運営される Cloud Files は、開発者や IT チームが利用するファイルストレージサービスです。

前提条件

まだ Rackspace Cloud のアカウントをお持ちでない場合、登録が必要です。Rackspace の Web サイトに記載されている手順に従ってください。

Cloud Files のユーザーとコンテナの作成

まず Rackspace のクラウドコントロールパネルから、制限されたアクセス許可を持つ Cloud Files ユーザーを作成します。

1. Rackspace のクラウドコントロールパネルにログインします。
2. User account メニューから User Management を選択します。
3. Create User をクリックし、適切な詳細をすべて入力します。
4. Product Access セクションで User Role を Custom に設定します。
5. Product Access リストを確認します。Product 欄のすべての項目に対して Files 項目を除いて、Role を No Access に設定します。
6. Files の項目の Role を Admin に設定します。これにより、ユーザーはログを保存するファイルを作成できますが、他のサービスにアクセスすることができなくなります。

次に、Cloud Files アカウントの API キーを確認します。Cloud Files API を使用して認証するために、後でこれを使用します。

1. ユーザーアカウントメニューから Account Settings を選択します。
2. Login detailsで API キーを表示し、キーを書き留めておきます。

Cloud Files ユーザーを作成し、API キーの確認ができたところで、Cloud Files コンテナを設定します。

1. Storage メニューから Files を選択します。
2. Create Container をクリックします。
3. コンテナに Fastly logs - my service のような分かりやすい名前を割り当てます。
4. 地域を選択し、ファイルを保存し、コンテナがプライベートであることを確認します。
5. Create Container をクリックします。

Cloud Files のログエンドポイントの追加

Cloud Files のユーザーとコンテナを作成したら、以下の手順に従い Cloud Files をログエンドポイントとして追加します。

1. Rust、AssemblyScript、および JavaScript で書かれた Compute@Edge コードでログ記録を実行する方法に関する詳細については Fastly の開発者向けドキュメントをご覧ください。
2. Rackspace Cloud Files の Create endpoint ボタンをクリックします。 Create a Cloud Files endpoint ページが表示されます。
3. Create a Cloud Files endpoint フィールドに以下のように記入します。
   • Name フィールドに、Compute@Edge コードに指定した名前を入力します。例えば、Rust コードの例では、名前は my_endpoint_name です。
   • Timestamp format フィールドに、ログファイルのタイムスタンプ形式を任意で入力します。デフォルトは strftime 互換形式の文字列です。詳細については、ログファイルの書き込み先の変更に関するガイドを参照してください。
   • Bucket name フィールドに、ログを保存する Cloud Files コンテナの名前を入力します。
   • User フィールドに、上記で作成した Cloud Files ユーザーのユーザー名を入力します。
   • Access keyフィールドに、Cloud Files アカウントの API キーを入力します。
   • Period フィールドに、ログファイルのローテーションの頻度をコントロールするための間隔 (秒単位) を任意で入力します。この値はデフォルトで3600秒に設定されています。
4. Create a Cloud Files endpoint ページの Advanced options リンクをクリックし、必要に応じてオプションフィールドを変更します。
5. Create a Cloud Files endpoint ページの Advanced options で以下のように入力します。
   • Path フィールドには、ファイルを保存するバケット内のパスを任意で入力します。パスの末尾にはスラッシュが付きます。このフィールドを空にすると、ファイルはバケットのルートパスに保存されます。詳細については、ログファイルの書き込み先の変更に関するガイドを参照してください。
   • PGP public key フィールドに、Fastly がディスクに書き込む前にログファイルを暗号化するために使用する PGP 公開鍵を任意で入力します。秘密鍵で復号化することによってのみ、コンテンツを読むことができます。PGP キーは PEM (プライバシー強化メール) 形式でなければなりません。詳細については、ログの暗号化に関するガイドをご覧ください。
   • Select a log line format のセクションで、ログメッセージのログライン形式を選択します。詳細については、ログライン形式の変更に関するガイドをご覧ください。
   • Regionメニューから、ログの送信先の地域を選択します。
   • Compression フィールドに、ログファイルに適用する圧縮形式を任意で選択します。ログ圧縮オプションの変更に関するガイドをご参照ください。
6. Create ボタンをクリックすると、新しいログエンドポイントが作成されます。
7. Activate ボタンをクリックして設定変更をデプロイします。