Fixup test code and add a new documnet

Author: Yoichi Kawasaki

README.md

@@ -11,10 +11,20 @@
 |  < 0.3.0 | >= v0.12.0 | >= 1.9 |
 
 ## Installation
+### Installing gems into system Ruby
 ```
 $ gem install fluent-plugin-azure-loganalytics
 ```
 
+### Installing gems into td-agent’s Ruby
+If you installed td-agent and want to add this custom plugins, use td-agent-gem to install as td-agent has own Ruby so you should install gems into td-agent’s Ruby, not system Ruby:
+
+```
+$ /usr/sbin/td-agent-gem install fluent-plugin-azure-loganalytics
+```
+Please see also [I installed td-agent and want to add custom plugins. How do I do it?](https://docs.fluentd.org/v0.12/articles/faq#i-installed-td-agent-and-want-to-add-custom-plugins.-how-do-i-do-it?)
+
+
 ## Configuration
 
 ### Azure Log Analytics
@@ -119,7 +129,7 @@ The output record for sample input can be seen at Log Analytics portal like this
 
 
 ## Tests
-### Running test code
+### Running test code (using System rake)
 ```
 $ git clone https://github.com/yokawasa/fluent-plugin-azure-loganalytics.git
 $ cd fluent-plugin-azure-loganalytics
@@ -131,6 +141,18 @@ $ vi test/plugin/test_azure_loganalytics.rb
 $ rake test
 ```
 
+### Running test code (using td-agent's rake)
+```
+$ git clone https://github.com/yokawasa/fluent-plugin-azure-loganalytics.git
+$ cd fluent-plugin-azure-loganalytics
+
+# edit CONFIG params of test/plugin/test_azure_loganalytics.rb
+$ vi test/plugin/test_azure_loganalytics.rb
+
+# run test 
+$ /opt/td-agent/embedded/bin/rake test
+```
+
 ### Creating package, running and testing locally
 ```
 $ rake build
@@ -148,9 +170,9 @@ $ ab -n 5 -c 2 http://localhost/test/foo.html
 
 ## Links
 
-* http://yokawasa.github.io/fluent-plugin-azure-loganalytics
 * https://rubygems.org/gems/fluent-plugin-azure-loganalytics
 * https://rubygems.org/gems/azure-loganalytics-datacollector-api
+* [How to install td-agent and luent-plugin-azure-loganalytics plugin on RHEL](docs/install-tdagent-and-the-plugin-on-rhel.md)
 
 ## Contributing
 

docs/install-tdagent-and-the-plugin-on-rhel.md

@@ -0,0 +1,68 @@
+# How to install td-agent and luent-plugin-azure-loganalytics plugin on RHEL
+
+This is a quick installation procedure of td-agent and the custom plugin (fluent-plugin-azure-loganalytics) on Red Hat Enterprise Linux (7.4) 
+
+$ cat /etc/os-release
+```
+NAME="Red Hat Enterprise Linux Server"
+VERSION="7.4 (Maipo)"
+ID="rhel"
+ID_LIKE="fedora"
+VARIANT="Server"
+VARIANT_ID="server"
+VERSION_ID="7.4"
+PRETTY_NAME="Red Hat Enterprise Linux Server 7.4 (Maipo)"
+ANSI_COLOR="0;31"
+CPE_NAME="cpe:/o:redhat:enterprise_linux:7.4:GA:server"
+HOME_URL="https://www.redhat.com/"
+BUG_REPORT_URL="https://bugzilla.redhat.com/"
+
+REDHAT_BUGZILLA_PRODUCT="Red Hat Enterprise Linux 7"
+REDHAT_BUGZILLA_PRODUCT_VERSION=7.4
+REDHAT_SUPPORT_PRODUCT="Red Hat Enterprise Linux"
+REDHAT_SUPPORT_PRODUCT_VERSION="7.4"
+```
+
+## 0. prerequisites (for Redhat/Centos)
+Install GCC and Development Tools on a CentOS / RHEL 7 server
+```
+$ suod yum group install "Development Tools"
+```
+
+## 1. Install td-agent (fluentd)
+
+Following the fluentd official page, install like this:
+https://docs.fluentd.org/v0.12/articles/install-by-rpm
+```
+$ curl -L https://toolbelt.treasuredata.com/sh/install-redhat-td-agent2.sh | sh
+
+$ td-agent --version
+td-agent 0.12.40
+```
+
+## 2. Launching Daemon
+```
+$ sudo /etc/init.d/td-agent start
+$ sudo /etc/init.d/td-agent status
+```
+## 3. Post Sample Logs via HTTP
+By default, /etc/td-agent/td-agent.conf is configured to take logs from HTTP and route them to stdout (/var/log/td-agent/td-agent.log). You can post sample log records using the curl command.
+
+```
+$ curl -X POST -d 'json={"json":"message"}' http://localhost:8888/debug.test
+
+# Checking log (/var/log/td-agent/td-agent.log) and see if the log is written
+$ cat /var/log/td-agent/td-agent.log
+```
+
+## 4. Install the custom plugin
+```
+$ sudo /usr/sbin/td-agent-gem install fluent-plugin-azure-loganalytics
+```
+
+## 5. Testing the plugin
+```
+$ git clone https://github.com/yokawasa/fluent-plugin-azure-loganalytics.git
+$ cd fluent-plugin-azure-loganalytics
+$ /opt/td-agent/embedded/bin/rake test
+```

test/plugin/test_azure_loganalytics.rb

@@ -22,12 +22,10 @@ def create_driver(conf = CONFIG)
 
   def test_configure
     d = create_driver
-    assert_equal '<Customer ID aka WorkspaceID String>', d.instance.customer_id
-    assert_equal '<Primary Key String>', d.instance.shared_key
     assert_equal 'ApacheAccessLog', d.instance.log_type
-    assert_true d.instance.add_time_field
-    assert_true d.instance.localtime
-    assert_true d.instance.add_tag_field
+    assert_equal true, d.instance.add_time_field
+    assert_equal true, d.instance.localtime
+    assert_equal true, d.instance.add_tag_field
     assert_equal 'tag', d.instance.tag_field_name
   end