blob: 57799bc5175872a572f4ef7fa1061ed341e86acc [file] [log] [blame]
# SOME DESCRIPTIVE TITLE.
# Copyright (C)
# This file is distributed under the same license as the Apache CloudStack Administration Documentation package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Apache CloudStack Administration Documentation 4\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2014-03-31 14:08-0400\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../events.rst:18
# 102ed2ffb3fb4c3bb6029d0c7eb905de
msgid "Event Notification"
msgstr ""
#: ../../events.rst:20
# afc241a8b0d0496a8744768e3563fbe8
msgid "An event is essentially a significant or meaningful change in the state of both virtual and physical resources associated with a cloud environment. Events are used by monitoring systems, usage and billing systems, or any other event-driven workflow systems to discern a pattern and make the right business decision. In CloudStack an event could be a state change of virtual or physical resources, an action performed by an user (action events), or policy based events (alerts)."
msgstr ""
#: ../../events.rst:29
# 0fca00203fea49669148771eeedf55c3
msgid "Event Logs"
msgstr ""
#: ../../events.rst:31
# 1d21fa8ae81748baa8e52f31043facf7
msgid "There are two types of events logged in the CloudStack Event Log. Standard events log the success or failure of an event and can be used to identify jobs or processes that have failed. There are also long running job events. Events for asynchronous jobs log when a job is scheduled, when it starts, and when it completes. Other long running synchronous jobs log when a job starts, and when it completes. Long running synchronous and asynchronous event logs can be used to gain more information on the status of a pending job or can be used to identify a job that is hanging or has not started. The following sections provide more information on these events.."
msgstr ""
#: ../../events.rst:43
# 8a0c6176934d4aec840789a07a73084b
msgid "Notification"
msgstr ""
#: ../../events.rst:45
# 64816315eaa145ab8ad138648b2589e3
msgid "Event notification framework provides a means for the Management Server components to publish and subscribe to CloudStack events. Event notification is achieved by implementing the concept of event bus abstraction in the Management Server. An event bus is introduced in the Management Server that allows the CloudStack components and extension plug-ins to subscribe to the events by using the Advanced Message Queuing Protocol (AMQP) client. In CloudStack, a default implementation of event bus is provided as a plug-in that uses the RabbitMQ AMQP client. The AMQP client pushes the published events to a compatible AMQP server. Therefore all the CloudStack events are published to an exchange in the AMQP server."
msgstr ""
#: ../../events.rst:57
# 69559e28bd3c4833a65e235470bd7ae9
msgid "A new event for state change, resource state change, is introduced as part of Event notification framework. Every resource, such as user VM, volume, NIC, network, public IP, snapshot, and template, is associated with a state machine and generates events as part of the state change. That implies that a change in the state of a resource results in a state change event, and the event is published in the corresponding state machine on the event bus. All the CloudStack events (alerts, action events, usage events) and the additional category of resource state change events, are published on to the events bus."
msgstr ""
#: ../../events.rst:68
# c7c4a9021bb94d0d8c8806bdc797abc7
msgid "Use Cases"
msgstr ""
#: ../../events.rst:70
# 2b32e72970d74bd3b50d67a5c2b25913
msgid "The following are some of the use cases:"
msgstr ""
#: ../../events.rst:74
# 785e64cd20c945e39b1fcd1248e29463
msgid "Usage or Billing Engines: A third-party cloud usage solution can implement a plug-in that can connects to CloudStack to subscribe to CloudStack events and generate usage data. The usage data is consumed by their usage software."
msgstr ""
#: ../../events.rst:81
# 697fd51abda3475fbec2bfb2cf48eeee
msgid "AMQP plug-in can place all the events on the a message queue, then a AMQP message broker can provide topic-based notification to the subscribers."
msgstr ""
#: ../../events.rst:87
# 13d4c3bf275446aca6afcc5f13b12aa3
msgid "Publish and Subscribe notification service can be implemented as a pluggable service in CloudStack that can provide rich set of APIs for event notification, such as topics-based subscription and notification. Additionally, the pluggable service can deal with multi-tenancy, authentication, and authorization issues."
msgstr ""
#: ../../events.rst:94
# 1aedf09c5c0b4effa9dd9117fcf5a102
msgid "Configuration"
msgstr ""
#: ../../events.rst:96
# 1520275479c3459fb8bb45890eae9935
msgid "As a CloudStack administrator, perform the following one-time configuration to enable event notification framework. At run time no changes can control the behaviour."
msgstr ""
#: ../../events.rst:102
# e80abe3d28594327a0464339d8818c44
msgid "Open ``'componentContext.xml``."
msgstr ""
#: ../../events.rst:106
# 9df0be28f95041d19f82142547b7265b
msgid "Define a bean named ``eventNotificationBus`` as follows:"
msgstr ""
#: ../../events.rst:110
# e46a3a197cc74df2a9eb8e5bd57ebf52
msgid "name : Specify a name for the bean."
msgstr ""
#: ../../events.rst:114
# b203c95bc9f44afc81fbb8980802291e
msgid "server : The name or the IP address of the RabbitMQ AMQP server."
msgstr ""
#: ../../events.rst:118
# 6e8c151c2dd847f1a2a160d97c119e86
msgid "port : The port on which RabbitMQ server is running."
msgstr ""
#: ../../events.rst:122
# 42911e580f7a4f6fa5b5be87551390cb
msgid "username : The username associated with the account to access the RabbitMQ server."
msgstr ""
#: ../../events.rst:127
# 887fd9bc57b548f382e1c635c3dbb8a0
msgid "password : The password associated with the username of the account to access the RabbitMQ server."
msgstr ""
#: ../../events.rst:132
# 4c518b7b80a941638553284affb8603e
msgid "exchange : The exchange name on the RabbitMQ server where CloudStack events are published."
msgstr ""
#: ../../events.rst:135
# f881113c3c1540c9a568b4bb01f37ff2
msgid "A sample bean is given below:"
msgstr ""
#: ../../events.rst:148
# c88f66382e86471fa752a96e8c286e51
msgid "The ``eventNotificationBus`` bean represents the ``org.apache.cloudstack.mom.rabbitmq.RabbitMQEventBus`` class."
msgstr ""
#: ../../events.rst:153
# 3c84696f04ae4ad58c0edfe8eee24a49
msgid "Restart the Management Server."
msgstr ""
#: ../../events.rst:156
# 34f2df7b30c8489690de80ca02292b43
msgid "Standard Events"
msgstr ""
#: ../../events.rst:158
#: ../../events.rst:191
# 658ab70617ca480387c4446d2df3f783
# e43e53282a8743bc94e7a3f26dacfeed
msgid "The events log records three types of standard events."
msgstr ""
#: ../../events.rst:162
#: ../../events.rst:195
# 9400dae867ab48dfb95e9a05e8949fdb
# cb299fcbd64849a7a47486675d1f6477
msgid "INFO. This event is generated when an operation has been successfully performed."
msgstr ""
#: ../../events.rst:167
#: ../../events.rst:200
# 294607854e004c4fa685bb9760e11d2f
# 26f912bd36f4415c9f6349109dbc880a
msgid "WARN. This event is generated in the following circumstances."
msgstr ""
#: ../../events.rst:171
#: ../../events.rst:204
# 8f26ab07f1da41c5a67f35568dee82ae
# a962175d5c794f9e88b25a995aa3fe1a
msgid "When a network is disconnected while monitoring a template download."
msgstr ""
#: ../../events.rst:176
#: ../../events.rst:209
# 41d6341dfbc74296aebd0eff9602f59a
# 9bdea7d661d140718fea5fda4ae30615
msgid "When a template download is abandoned."
msgstr ""
#: ../../events.rst:180
#: ../../events.rst:213
# d2d6ebc19c2f42138e8698f89ee29c6f
# 93031d47c5704fb383a9e8149b602855
msgid "When an issue on the storage server causes the volumes to fail over to the mirror storage server."
msgstr ""
#: ../../events.rst:185
#: ../../events.rst:218
# 583a50a8c403401093490e43cbd95dfd
# 52ea4911fdfe42a5af3cc9a97e48a987
msgid "ERROR. This event is generated when an operation has not been successfully performed"
msgstr ""
#: ../../events.rst:189
# 5b8500630feb40f4afb3b8f9e29a53a3
msgid "Long Running Job Events"
msgstr ""
#: ../../events.rst:222
# c379b57670384b0b9da909afafca7292
msgid "Event Log Queries"
msgstr ""
#: ../../events.rst:224
# 88a9f85fb3da4603bee07701eabb7806
msgid "Database logs can be queried from the user interface. The list of events captured by the system includes:"
msgstr ""
#: ../../events.rst:229
# cd15e4ae2eca4d55b7510293e7fd2bbd
msgid "Virtual machine creation, deletion, and on-going management operations"
msgstr ""
#: ../../events.rst:234
# 2df022a424dc41b699e1367171be2d50
msgid "Virtual router creation, deletion, and on-going management operations"
msgstr ""
#: ../../events.rst:238
# d36f900c99fb40fa94804d5e52af7822
msgid "Template creation and deletion"
msgstr ""
#: ../../events.rst:242
# 2e97521ac7be4b15b4892a30073bc966
msgid "Network/load balancer rules creation and deletion"
msgstr ""
#: ../../events.rst:246
# f59bcdcfa249464a800cad1cd97cfc0f
msgid "Storage volume creation and deletion"
msgstr ""
#: ../../events.rst:250
# 8bd53c90bb38449fbbadd472c0930466
msgid "User login and logout"
msgstr ""
#: ../../events.rst:253
# 1e928be3f4e54e8f8b6532879b4e5f7e
msgid "Deleting and Archiving Events and Alerts"
msgstr ""
#: ../../events.rst:255
# 13275df9c48f45ccba383ca172df3874
msgid "CloudStack provides you the ability to delete or archive the existing alerts and events that you no longer want to implement. You can regularly delete or archive any alerts or events that you cannot, or do not want to resolve from the database."
msgstr ""
#: ../../events.rst:260
# 1371e435af2d4271b9db506b9e5c40aa
msgid "You can delete or archive individual alerts or events either directly by using the Quickview or by using the Details page. If you want to delete multiple alerts or events at the same time, you can use the respective context menu. You can delete alerts or events by category for a time period. For example, you can select categories such as **USER.LOGOUT**, **VM.DESTROY**, **VM.AG.UPDATE**, **CONFIGURATION.VALUE.EDI**, and so on. You can also view the number of events or alerts archived or deleted."
msgstr ""
#: ../../events.rst:269
# c8695ccfaf37456c9fe6e0ec4d207a62
msgid "In order to support the delete or archive alerts, the following global parameters have been added:"
msgstr ""
#: ../../events.rst:274
# d437d10a6c5c4d4fac98d68635980067
msgid "**alert.purge.delay**: The alerts older than specified number of days are purged. Set the value to 0 to never purge alerts automatically."
msgstr ""
#: ../../events.rst:279
# 368c17d62d6043429befbae6871a04c0
msgid "**alert.purge.interval**: The interval in seconds to wait before running the alert purge thread. The default is 86400 seconds (one day)."
msgstr ""
#: ../../events.rst:283
# 57dd9b95bbcf4bfd87ebf5cbaef78931
msgid "Archived alerts or events cannot be viewed in the UI or by using the API. They are maintained in the database for auditing or compliance purposes."
msgstr ""
#: ../../events.rst:288
# ec3e8f0b43514403afc0a9e47f381c0c
msgid "Permissions"
msgstr ""
#: ../../events.rst:290
# 7db5396af5d24382a51e418ced931fff
msgid "Consider the following:"
msgstr ""
#: ../../events.rst:294
# 2814ee39c91e4c2e832d73a1a39839b5
msgid "The root admin can delete or archive one or multiple alerts or events."
msgstr ""
#: ../../events.rst:299
# 01be1c88e97f4e9eae1e310e28045ae2
msgid "The domain admin or end user can delete or archive one or multiple events."
msgstr ""
#: ../../events.rst:303
# 8d806f13fadd4080bae10069ad330bbc
msgid "Procedure"
msgstr ""
#: ../../events.rst:307
# 0670181e1983452ab571f7ae6ce4d594
msgid "Log in as administrator to the CloudStack UI."
msgstr ""
#: ../../events.rst:311
# 3ab15d176fec4a14a47ed28c4e81a0bc
msgid "In the left navigation, click Events."
msgstr ""
#: ../../events.rst:315
# 3dfc816afe4744f1a2b5aa030c3be966
msgid "Perform either of the following:"
msgstr ""
#: ../../events.rst:319
# 3308c260b9c8454bb6109c2b36420617
msgid "To archive events, click Archive Events, and specify event type and date."
msgstr ""
#: ../../events.rst:324
# 3563bec70a3f40aa9bfd26494bda8c93
msgid "To archive events, click Delete Events, and specify event type and date."
msgstr ""
#: ../../events.rst:329
# f0ab5197a41b478684c629f86f95fc12
msgid "Click OK."
msgstr ""