Supervisión de datos con un socket

Puede definir un origen de datos para recopilar datos de una aplicación externa utilizando un socket TCP. La aplicación debe iniciar la conexión TCP al agente y enviar datos en un formato XML estructurado. En función de la aplicación, el origen de datos puede producir un conjunto de datos con una sola fila, varias filas, o datos de sucesos.

1. En la página Origen de datos inicial del agente o la página Ubicación de origen de datos, pulse Programas personalizados en el área Categorías de datos de supervisión.
2. En el área Orígenes de datos, pulse Socket.
3. Pulse Siguiente.
4. En la página Información de socket, especifique un nombre de grupo de atributos.
5. Especifique un texto de ayuda para el grupo de atributos.
6. Seleccione si el grupo de atributos Produce una sola fila de datos, Puede producir más de una fila de datos o Produce sucesos. Para obtener más información, consulte el apartado Envío de datos.
7. En la sección Información sobre socket, seleccione Página de códigos. Para obtener más información, consulte el apartado Juegos de caracteres.
8. Opcional: Pulse Avanzado para modificar las propiedades avanzadas del grupo de atributos. La opción Avanzado está activa cuando se selecciona que el grupo de atributos Puede producir más de una fila de datos o Produce sucesos.
9. Pulse Siguiente.
10. En la página Información de atributos, especifique el primer atributo para el grupo de atributos. Para obtener más información sobre la creación de atributos, consulte Creación de atributos.
11. Pulse Siguiente.
12. Opcional: En la página Información de origen de datos de socket global, la sección Códigos de error, puede definir los códigos de error que puede enviar el cliente de socket cuando no puede recopilar datos. Para obtener más información, consulte (Envío de errores en lugar de datos). Para definir un código de error, siga estos pasos:
    1. En la sección Códigos de error, pulse Añadir. Un código de error tiene un límite de 256 caracteres. Sólo están permitidos las letras ASCII, los dígitos y los subrayados. No se permiten espacios.
    2. En la ventana Definición del código de error de socket, especifique un valor de visualización que se muestra en el grupo de atributos Estado de objeto de rendimiento.
    3. Especifique un valor interno. El valor interno debe ser un entero desde 1.000 a 2.147.483.647.
    4. Debe definir un texto del mensaje para cada error. Puede utilizar el texto de mensaje que se ha especificado previamente seleccionándolo en la lista. Pulse Aceptar para volver a la página Información de origen de datos de socket global. El texto del mensaje se utiliza en el archivo de registro del agente.
       Si no hay disponible ningún texto de mensaje adecuado, pulse Examinar para configurar el texto del mensaje. Se abre la ventana Mensajes (lista). La ventana de mensajes muestra una lista de los mensajes que están definidos en el agente. Hasta que defina mensajes, la lista permanece en blanco. Puede utilizar Editar para alterar un mensaje definido y Eliminar para suprimir uno o más mensajes que ha definido.
    5. 
       
       En la ventana Mensajes (lista), pulse Añadir para ver una ventana Definición de mensaje. En la ventana Definición de mensaje, escriba el texto que describa el significado del nuevo mensaje y seleccione el tipo de mensaje.

       Nota: El identificador de mensaje se generará de forma automática.
    6. Pulse Aceptar.
    7. Se abre la ventana Mensajes (lista), con el nuevo mensaje. Para verificar el mensaje y volver a la página Información de origen de datos de socket global, pulse Aceptar.
13. Opcional: En la sección Archivos complementarios de la página Información de origen de datos de socket global, puede añadir archivos que están empaquetados con el agente. Estos archivos se copian en el sistema del agente al instalarlo.
    La columna Tipo de archivo describe cómo espera utilizarse cada archivo. Se describen tres posibles usos en la siguiente tabla:

    Tabla 1. Tipos de archivos para archivos complementarios

    Tipo de archivo	Descripción
    Ejecutable	Seleccione esta opción si desea incluir un archivo ejecutable con el agente. El agente no utiliza estos archivos.
    Biblioteca	Seleccione esta opción si desea incluir una biblioteca con el agente. El agente no utiliza estos archivos.
    Recurso Java™	Seleccione esta opción para incluir recursos Java con el agente. El agente no utiliza estos archivos.

    Para obtener información sobre dónde se instalan los archivos complementarios con el agente, consulte Nuevos archivos en el sistema.

    Pulse Editar para editar el archivo importado. Para obtener más información, consulte (Edición de una definición de archivo de mandatos).

14. Opcional: Puede probar este grupo de atributos pulsando Probar. Para obtener más información sobre pruebas, consulte Prueba de grupos de atributos de socket
15. Opcional: Si se muestrea el origen de datos, puede crear un filtro para limitar los datos que este grupo de atributos devuelve pulsando Avanzado. El origen de datos se muestrea cuando no se ha seleccionado "Produce sucesos" en la página Información de socket. Para obtener más información sobre el filtrado de datos desde un grupo de atributos, consulte Filtrado de grupo de atributos
16. Realice una de las acciones siguientes:
    1. Si utiliza el Asistente de agente, pulse Siguiente.
    2. Pulse en Finalizar para guardar el origen de datos y abrir Agent Editor.
       Seleccione los sistemas operativos en los que el agente escucha los datos de los clientes de socket en la sección Sistemas operativos de la página Valores de proveedor de sockets. Para abrir la página, pulse Valores de proveedor de sockets en la vista de esquema o pulse Valores globales en Agent Editor en cualquier página de grupo de atributos de socket.

       Nota: Los códigos de error y los archivos complementarios se pueden actualizar en las secciones Códigos de error y Archivos complementarios de la página Valores de proveedor de sockets.