<chapter id="eventmonitoring">
<title
>Monitorização de Eventos</title>
<para
>Um objecto de dados de monitorização de eventos mantém essencialmente o registo de um ou mais vectores ou valores escalares e efectua uma determinada acção sempre que uma condição indicada que envolva os vectores ou escalares for verdadeira. Os monitores de eventos são normalmente usados em conjunto com os dados transmitidos ou em <quote
>tempo-real</quote
>. Por exemplo, poderá ser criado um monitor de eventos para vigiar se os elementos de um vector de dados que representam uma temperatura ultrapassam um valor predefinido. </para>

<sect1 id="eventmonitordialog">
<title
>Janela de Monitorização de Eventos</title>

<para
>A seguir encontra-se uma imagem da janela que é mostrada ao criar ou editar eventos. As explicações das configurações são listadas em baixo. </para>

<screenshot>
<screeninfo
>Janela de Monitorização de Eventos</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-eventmonitor.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Janela de Monitorização de Eventos</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect2 id="eventsexpression">
<title
>Expressão</title>
<para
>A condição a monitorizar, em conjunto com outras propriedades do evento, poderão ser modificadas nesta secção. </para>

<variablelist>
<varlistentry>
<term>
<guilabel
>Operadores</guilabel>
</term>
<listitem>
<para
>Uma lista com os operadores disponíveis. Se escolher um operador da lista irá inserir o operador no ponto de inserção actual no campo <guilabel
>Expressão</guilabel
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Vectores</guilabel>
</term>
<listitem>
<para
>Uma lista com os objectos de vectores actuais no &kst;. Se escolher um vector da lista irá inserir o vector no ponto de inserção actual do campo <guilabel
>Expressão</guilabel
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Escalares</guilabel>
</term>
<listitem>
<para
>Uma lista com os valores escalares disponíveis. Esta lista é composta tanto pelos valores escaláveis na sessão actual do &kst;, assim como algumas constantes incorporadas. Se escolher um valor escalar da lista irá inserir esse valor no ponto de inserção actual do campo <guilabel
>Expressão</guilabel
>. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guilabel
>Expressão</guilabel>
</term>
<listitem>
<para
>A expressão a monitorizar. Poderá escrever directamente neste campo de texto ou seleccionar os itens a introduzir a partir das listas acima. Garanta que a expressão introduzida neste campo de texto é uma expressão booleana (isto é, é avaliada como verdadeira ou falsa). Isto normalmente corresponde a usar um operador de igualdade ou desigualdade na expressão. Lembre-se que os vectores introduzidos no campo de texto serão monitorizados de acordo com os seus elementos individuais. </para>
<para
>Sempre que esta expressão for verdadeira, o evento será despoletado. A acção efectuada a partir daí depende da configuração indicada nas duas secções seguintes. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Descrição</guilabel>
</term>
<listitem>
<para
>Este campo de texto é usado para guardar uma breve descrição do evento. A descrição está normalmente disponível como um método para manter um registo dos vários eventos. Poderá indicar qualquer texto que deseje neste campo. </para>
</listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2 id="eventskstdebuglog">
<title
>Registo de Depuração do Kst</title>
<para
>Esta secção indica a configuração dos itens adicionados ao registo de depuração do &kst; quando os eventos forem despoletados. </para>
<variablelist>
<varlistentry>
<term
><guilabel
>Registar como:</guilabel
></term>
<listitem>
<para
>Active esta opção para que os itens sejam adicionados ao registo de depuração do &kst; sempre que este evento for despoletado. Existem três tipos de itens no registo de depuração &mdash; informações, avisos e erros. Seleccione o tipo de intem desejado com a opção exclusiva correspondente. </para>
</listitem>
</varlistentry>
</variablelist>


</sect2>

<sect2 id="eventsemailnotification">
<title
>Notificação por E-mail</title>
<para
>Nesta secção poderão ser indicadas as configurações para enviar notificações por e-mail dos eventos. </para>

<variablelist>
<varlistentry>
<term
><guilabel
>Notificar</guilabel
></term>
<listitem>
<para
>Assinale esta opção para que o &kst; envie notificações por e-mail para o endereço indicado sempre que este evento for despoletado. Depois, introduza o endereço de e-mail que deseja que apareça no campo <quote
>De</quote
> da mensagem de e-mail no campo de texto <guilabel
>Remetente</guilabel
>. </para>
</listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2 id="eventselog">
<title
>ELOG</title>
<para
>O &kst; suporta a introdução dos itens num registo ELOG sempre que um evento ocorre. Isto poderá ser útil para monitorizar remotamente os dados em tempo-real ou para obter resumos das actividades dos eventos. </para>

<variablelist>
<varlistentry>
<term
><guilabel
>Notificar</guilabel
></term>
<listitem>
<para
>Se seleccionar esta opção, irá activar a funcionalidade de registo no ELOG para este monitor de eventos. Carregue em <guibutton
>Configurar...</guibutton
> para indicar as configurações de registo e do servidor. </para>
</listitem>
</varlistentry>
</variablelist>
</sect2>

</sect1>

<sect1 id="elogextension">
<title
>A Extensão ELOG</title>
<para
>A extensão do ELOG permite aos monitores de eventos criarem itens de registo num servidor que esteja a correr a aplicação Electronic Logbook (ELOG). Os itens de registo criados podem ser usados, por exemplo, para monitorizar remotamente os eventos do &kst; ou para produzir relatórios periódicos dos dados. Para mais informações sobre a configuração e manutenção de um servidor de ELOG, veja por favor a <ulink url="http://midas.psi.ch/elog/"
>Página Oficial do ELOG</ulink
>. Para activar a extensão do ELOG no &kst;, seleccione a opção <guimenuitem
>Extensões...</guimenuitem
> do menu <guimenu
>Configuração</guimenu
> e garanta que a <quote
>Extensão ELOG</quote
> está assinalada. </para>

<sect2 id="elogextensionsettings">
<title
>Configuração de Registo e do Servidor</title>
<para
>As opções de registo e do servidor deverão ser configuradas se a funcionalidade do ELOG estiver activada para um objecto de monitorização de eventos. Para configurar as opções de registo, carregue no botão <guibutton
>Configurar...</guibutton
> da secção <guilabel
>ELOG</guilabel
> da janela do Monitor de Eventos. A janela de Item do Evento ELOG deverá ser mostrada: </para>
<screenshot>
<screeninfo
>Configuração do Registo da Monitorização de Eventos</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-eventmonitor-loggingsettings.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Configuração do Registo da Monitorização de Eventos</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Use as três opções em baixo para seleccionar o tipo de informação a ser registada. O <guilabel
>Incluir a captura do Kst</guilabel
> indica que deverá ser incluída uma captura do ecrã da janela actual no item. O <guilabel
>Incluir o ficheiro de configuração do Kst</guilabel
> indica que o ficheiro <filename
>*.kst</filename
> gravado deverá ser anexado ao item. Finalmente, se a opção <guilabel
>Incluir a informação de depuração do Kst</guilabel
> estiver assinalada, será também anexada uma cópia do <link linkend="debuglog"
>registo de depuração</link
> ao item. </para>

<para
>Irão aparecer campos adicionais nesta janela, logo que as opções do servidor de ELOG estejam configuradas. Para personalizar as opções do servidor de ELOG, carregue no botão <guibutton
>Configuração...</guibutton
>. Deverá ser mostrada a seguinte janela: </para>

<screenshot>
<screeninfo
>Configuração do Servidor de Monitorização de Eventos</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-eventmonitor-serversettings.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Configuração do Servidor de Monitorização de Eventos</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Segue-se uma descrição das opções desta janela. </para>
<variablelist>
<varlistentry>
<term
><guilabel
>Configuração</guilabel
>, <guibutton
>Gravar</guibutton
> e <guibutton
>Carregar</guibutton
> </term>
<listitem>
<para
>A lista da <guilabel
>Configuração</guilabel
> contém as configurações gravadas dos servidores de ELOG. Para carregar um conjunto de opções de configuração, seleccione um item na lista e carregue no botão <guibutton
>Carregar</guibutton
>. Para gravar a configuração actual nesta janela numa dada posição, seleccione a posição desejada e carregue no botão <guibutton
>Gravar</guibutton
>. </para>
<caution>
<para
>A configuração das opções numa dada posição sobrepõe a configuração existente para essa posição. </para>
</caution>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Endereço IP</guilabel
> e <guilabel
>Número de porto</guilabel
></term>
<listitem>
<para
>Indique o endereço IP da máquina que está a correr a aplicação do servidor de ELOG. O número de porto no qual o servidor de ELOG está à espera de dados é configurável neste, mas é por omissão igual a 8080 por isso, se não tiver a certeza, indique 8080 como número de porto. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Registo</guilabel
></term>
<listitem>
<para
>Cada servidor de ELOG poderá conter um ou mais registos, como tal o nome do registo onde os itens serão armazenados terá de ser indicado. Garanta que a ortografia do registo está correcta. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Utilizador</guilabel
>, <guilabel
>Senha</guilabel
> e <guilabel
>Gravar a senha</guilabel
></term>
<listitem>
<para
>Dependendo da forma como a aplicação servidora do ELOG está configurada, estas opções poderão ou não ser necessárias. Se o forem, indique as credenciais de autenticação correctas nos campos apropriados. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Tamanho da captura</guilabel
></term>
<listitem>
<para
>Use esta lista para seleccionar o tamanho em pixels da captura do ecrã do &kst; a anexar (se for indicada). </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Enviar como texto em HTML</guilabel
></term>
<listitem>
<para
>Se esta opção estiver seleccionada, as marcas de HTML poderão ser usadas no item do registo. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Suprimir a notificação por e-mail</guilabel
></term>
<listitem>
<para
>Se o registo estiver configurado para enviar notificações por e-mail dos itens novos, ao seleccionar esta opção irá desactivar essas notificações. Lembre-se que esta opção não está relacionada com a configuração das notificações por e-mail própria do &kst; para os monitores de eventos. </para>
</listitem>
</varlistentry>

</variablelist>

<para
>Carregue no botão <guibutton
>Aplicar</guibutton
> para tornar efectivas as opções introduzidas. Carregue em <guibutton
>Actualizar</guibutton
> para refrescar a janela do Item do Evento do ELOG (a janela anterior). Os campos adicionais deverão aparecer na janela do Item de Evento do ELOG. Estes campos são únicos no registo seleccionado. Logo que esteja satisfeito com as opções, o botão <guibutton
>Testar</guibutton
> pode ser utilizador para enviar um item do registo de teste. Carregue em <guibutton
>Fechar</guibutton
> para sair da janela. </para>
</sect2>

</sect1>
</chapter>