Browse Source

Added more instructions

1. Register kiloeyes as monitoring service with openstack keystone
2. Install monasca agent to send metrics to kiloeyes

Change-Id: Ia39aa44e44e63efb26435b1f379644c318acfb21
Tong Li 3 years ago
parent
commit
8c25b2db61
1 changed files with 62 additions and 4 deletions
  1. 62
    4
      README.md

+ 62
- 4
README.md View File

@@ -177,13 +177,71 @@ Install Kafka 0.9.0.0 scala 2.11 build::
177 177
          tar xf kafka_2.11-0.9.0.0.tgz
178 178
 
179 179
     3. Change to the kafka directory and start up zookeeper and kafka server:
180
-    
180
+
181 181
          ./bin/zookeeper-server-start.sh ./config/zookeeper.properties
182 182
          ./bin/kafka-server-start.sh ./config/server.properties 
183
-         
183
+
184 184
     4. Try to create a topic and make sure things running all right:
185
-    
185
+
186 186
          ./bin/kafka-topics.sh --create --topic test --zookeeper localhost:2181 --partitions 1 --replication-factor 1
187 187
 
188 188
 Install Kiloeyes dependencies, server and services by following instructions above.
189
- 
189
+
190
+
191
+Register kiloeyes as monitoring service with Keystone::
192
+=======================================================
193
+1. On the keystone server, setup environment variable:
194
+
195
+    export OS_USERNAME=admin
196
+    export OS_PASSWORD=<password>
197
+    export OS_TENANT_NAME=admin
198
+    export OS_AUTH_URL=http://localhost:5000/v2.0
199
+
200
+2. Create monitoring service by running the following command:
201
+
202
+    openstack service create --name kiloeyes --description "Monitoring" monitoring
203
+
204
+3. Create endpoint by running the following command:
205
+
206
+    openstack endpoint create --region RegionOne monitoring --publicurl http://<<kiloeyes_server_host_ip>>:9090/v2.0
207
+
208
+
209
+Install monasca-agent from the source::
210
+=======================================
211
+1. Get the source code:
212
+
213
+    git clone https://github.com/openstack/monasca-agent.git
214
+
215
+2. Change requirements.txt due to a bug in the monasca-agent project:
216
+
217
+    requests==2.8.1
218
+    psutil=3.4.2
219
+
220
+3. Install the requirements:
221
+
222
+    sudo apt-get install python-dev python-pip
223
+    sudo pip install -r requirements.txt
224
+
225
+4. Install monasca agents:
226
+
227
+    sudo python setup.py install
228
+
229
+5. Run the following command to create agent configurations:
230
+
231
+    sudo monasca-setup --username KEYSTONE_USERNAME --password KEYSTONE_PASSWORD --project_name KEYSTONE_PROJECT_NAME --keystone_url http://URL_OF_KEYSTONE_API:35357/v3
232
+
233
+    Replace KEYSTONE_USERNAME, KEYSTONE_PASSWORD, KEYSTONE_PROJECT_NAME,
234
+    URL_OF_KEYSTONE_API with correct value according to your openstack
235
+    keystone setups
236
+
237
+6. If the above runs with no errors, you need to add the following in
238
+/etc/monasca/agent/supervisor.conf file:
239
+
240
+    [inet_http_server]
241
+    port = localhost:9001
242
+
243
+7. Restart monasca agent services on the machine by running the following command:
244
+
245
+    sudo service monasca-agent restart
246
+
247
+8. Agent log files will be in /var/log/monasca/agent directory.

Loading…
Cancel
Save