<h1 id="%E6%A6%82%E8%A6%81"><a class="header-anchor-link" href="#%E6%A6%82%E8%A6%81" aria-hidden="true" rel="nofollow"></a> 概要</h1>
<p>EC2上で動くアプリケーションのログを <code>awslogs</code> を使ってCloudWatch Logsに送信する手順です。</p>
<h1 id="%E7%92%B0%E5%A2%83"><a class="header-anchor-link" href="#%E7%92%B0%E5%A2%83" aria-hidden="true" rel="nofollow"></a> 環境</h1>
<ul>
<li>Amazon Linux AMI release 2018.03</li>
<li>awslogs 1.1.4-1.12</li>
<li>EC2インスタンスにはインスタンスプロファイルがアタッチ済み</li>
</ul>
<h1 id="%E6%89%8B%E9%A0%86"><a class="header-anchor-link" href="#%E6%89%8B%E9%A0%86" aria-hidden="true" rel="nofollow"></a> 手順</h1>
<ul>
<li>
<p>EC2インスタンスに割り当てられているインスタンスプロファイルに、CloudWatch Logsへの書き込み権限を与える</p>
<p>インラインポリシーで許可する例</p>

      <div class="code-block-container">
        
        <pre class="language-json"><code class="language-json"><span class="token punctuation">{</span>
  <span class="token property">"Version"</span><span class="token operator">:</span> <span class="token string">"2012-10-17"</span><span class="token punctuation">,</span>
  <span class="token property">"Statement"</span><span class="token operator">:</span> <span class="token punctuation">[</span>
    <span class="token punctuation">{</span>
      <span class="token property">"Effect"</span><span class="token operator">:</span> <span class="token string">"Allow"</span><span class="token punctuation">,</span>
      <span class="token property">"Action"</span><span class="token operator">:</span> <span class="token punctuation">[</span>
        <span class="token string">"logs:CreateLogGroup"</span><span class="token punctuation">,</span>
        <span class="token string">"logs:CreateLogStream"</span><span class="token punctuation">,</span>
        <span class="token string">"logs:PutLogEvents"</span><span class="token punctuation">,</span>
        <span class="token string">"logs:DescribeLogStreams"</span>
      <span class="token punctuation">]</span><span class="token punctuation">,</span>
      <span class="token property">"Resource"</span><span class="token operator">:</span> <span class="token punctuation">[</span>
        <span class="token string">"*"</span>
      <span class="token punctuation">]</span>
    <span class="token punctuation">}</span>
  <span class="token punctuation">]</span>
<span class="token punctuation">}</span>
</code></pre>

      </div>
      </li>
<li>
<p>EC2インスタンスに <code>awslogs</code> をインストールする</p>

      <div class="code-block-container">
        
        <pre class="language-bash"><code class="language-bash">yum <span class="token function">install</span> -y awslogs
</code></pre>

      </div>
      </li>
<li>
<p><code>awslogs</code> の設定を行う</p>
<ul>
<li>
<p>設定ファイルは <code>/etc/awslogs/awslogs.conf</code> にある</p>
</li>
<li>
<p>どのファイルを、どの頻度で、どのロググループに送るのか等を設定できる</p>
<p>設定の記述方法は <a href="https://docs.aws.amazon.com/ja_jp/AmazonCloudWatch/latest/logs/AgentReference.html" rel="nofollow">CloudWatch Logs エージェントのリファレンス</a> を参照</p>
</li>
<li>
<p>設定の例</p>

      <div class="code-block-container">
        <div class="code-block-filename-container"><span class="code-block-filename">/etc/awslogs/awslogs.conf</span></div>
        <pre class="language-text"><code class="language-text">[general]
state_file = /var/lib/awslogs/agent-state
use_gzip_http_content_encoding = true

[/var/www/log/application.log]
file = /var/www/log/application.log*
log_group_name = application-log
log_stream_name = {instance_id}
datetime_format = '%Y-%m-%dT%H:%M:%S%z'
time_zone = LOCAL
initial_position = start_of_file
encoding = utf_8
</code></pre>

      </div>
      </li>
</ul>
</li>
<li>
<p>システム起動時に <code>awslogs</code> サービスが起動するようにする</p>

      <div class="code-block-container">
        
        <pre class="language-bash"><code class="language-bash"><span class="token function">chkconfig</span> awslogs on
</code></pre>

      </div>
      </li>
<li>
<p><code>awslogs</code> サービスを起動する</p>

      <div class="code-block-container">
        
        <pre class="language-bash"><code class="language-bash"><span class="token function">service</span> awslogs start
</code></pre>

      </div>
      </li>
</ul>
<h1 id="%E8%83%8C%E6%99%AF"><a class="header-anchor-link" href="#%E8%83%8C%E6%99%AF" aria-hidden="true" rel="nofollow"></a> 背景</h1>
<p>EC2でWebアプリケーションを構築していて、ログをインスタンスにアタッチしているEBSに書き込むと以下のような不都合が発生します。</p>
<ul>
<li>メンテナンス作業で、以前作成したAMIからインスタンスを作成して稼働中のインスタンスと差し替えるといった操作をする場合、AMI作成時点から作業時までのログが失われる</li>
<li>EC2インスタンスのストレージを徐々に圧迫する</li>
<li>EBSはハードウェア障害時の内容は保証されず、ログが失われる可能性がある</li>
<li>複数台のインスタンスを起動して冗長構成を取っている場合、ログを確認するのが手間（EFSを利用すれば解消できるかも）</li>
</ul>
<p>EC2インスタンスに可能な限り状態を持たせないようにするため、CloudWatch Logsにエクスポートするようにしたいと考えました。</p>
<h1 id="%E6%84%9F%E6%83%B3"><a class="header-anchor-link" href="#%E6%84%9F%E6%83%B3" aria-hidden="true" rel="nofollow"></a> 感想</h1>
<p><code>awslogs</code> を使うことで簡単にログをCloudWatch Logsに送信できました。CloudWatch Logsにフィルタを設定してログを監視することもできそうです。</p>
<p>EC2インスタンスからログの保存という役割は追い出せたものの、CloudWatch Logsも保存容量に応じた費用がかかるので、定期的にS3にアーカイブする設定も作った方が良さそうです。</p>
<p>インスタンスプロファイル経由で認証情報を得られるかと思いきや、作業環境では前任者がIAMユーザーを作成して認証情報を <code>~/.aws/credentials</code> に書き込んでいたためハマりました。</p>
<h1 id="%E5%8F%82%E8%80%83%E3%81%AB%E3%81%95%E3%81%9B%E3%81%A6%E3%81%84%E3%81%9F%E3%81%A0%E3%81%84%E3%81%9F%E3%82%B5%E3%82%A4%E3%83%88"><a class="header-anchor-link" href="#%E5%8F%82%E8%80%83%E3%81%AB%E3%81%95%E3%81%9B%E3%81%A6%E3%81%84%E3%81%9F%E3%81%A0%E3%81%84%E3%81%9F%E3%82%B5%E3%82%A4%E3%83%88" aria-hidden="true" rel="nofollow"></a> 参考にさせていただいたサイト</h1>
<ul>
<li><a href="https://docs.aws.amazon.com/ja_jp/AmazonCloudWatch/latest/logs/QuickStartEC2Instance.html" rel="nofollow">クイックスタート: 実行中の EC2 Linux インスタンスに CloudWatch Logs エージェントをインストールして設定する</a>
<ul>
<li>Amazon Linuxへのインストール方法が把握できました。</li>
</ul>
</li>
<li><a href="https://docs.aws.amazon.com/ja_jp/AmazonCloudWatch/latest/logs/AgentReference.html" rel="nofollow">CloudWatch Logs エージェントのリファレンス</a>
<ul>
<li>設定ファイルの記述方法を把握できました。</li>
</ul>
</li>
</ul>


tag: CloudWatch Logs