Skip to main content

Informe de uso de Alteryx Server

Utiliza el informe de uso de Server para comprender las métricas de usuarios, aplicaciones, permisos, programaciones y trabajos de modo que puedas evaluar rápidamente cualquier problema con el rendimiento, la auditoría y el cumplimiento. Conéctate a tu API de MongoDB y Server para extraer datos y analítica pertinentes de tu Alteryx Server fácilmente. Elige tu salida preferida, que incluye lo siguiente: Panel de control de Tableau, Separar archivos, Base de datos o utiliza las salidas de macro para procesos posteriores.

Puedes descargar el informe de uso de Server desde Alteryx Marketplace.

Requisitos

El informe de uso de Server es compatible con las versiones 2023.2 y posterior de Designer. Utiliza el parche disponible más reciente para tu versión de Designer.

Instala la utilidad del informe de uso de Server y las dependencias

Sigue estos pasos para instalar el informe de uso de Server y las dependencias asociadas.

Instala el YXI

  1. Descarga Server_Usage_Report.yxi desde Alteryx Marketplace.

  2. Haz doble clic en el archivo YXI para instalar la utilidad con Designer.

  3. Sigue las instrucciones:

    • Instalar para mi cuenta: solo tu cuenta de usuario tendrá acceso a la utilidad en la máquina. Se instala en: %AppData%\Alteryx\.

    • Instalar para todos los usuarios: todos los usuarios tendrán acceso a la utilidad en la máquina. Se instala en: %ProgramData%\Alteryx\.

  4. Después de finalizar, abre el flujo de trabajo Primeros pasos. En Designer, ve a Ayuda > Flujos de trabajo de muestra > Utilidades empresariales > Informe de uso de Server > Primeros pasos.

Instala el conector de Salida de Tableau

Nota

Este es un elemento opcional. El conector de Salida de Tableau solo es necesario si eliges escribir la salida en Tableau. El flujo de trabajo puede funcionar sin Salida de Tableau, siempre y cuando no selecciones la opción de escribir en Tableau.

  1. Descarga el conector de Salida de Tableau desde Alteryx Marketplace.

  2. Haz doble clic en el archivo YXI para instalar el conector mediante Designer.

  3. Sigue las instrucciones:

    • Instalar para mi cuenta: solo tu cuenta de usuario tendrá acceso a la herramienta en la máquina. Se instala en: %AppData%\Alteryx\.

    • Instalar para todos los usuarios: todos los usuarios tendrán acceso a la herramienta en la máquina. Se instala en: %ProgramData%\Alteryx\.

Instala el controlador Simba para MongoDB

  1. Descarga el controlador Simba desde el portal de licencias de Alteryx.

  2. Desplázate hasta la parte inferior de la sección Descargas de productos y selecciona Descargar a la derecha de la entrada Controladores.

  3. Selecciona MongoDB en la lista de versiones y, a continuación, Siguiente.

  4. Selecciona Descargar a la derecha de la entrada Simba MongoDB 2.3.22.1024 64-bit.

  5. Haz doble clic en el archivo MSI para instalar el controlador en tu máquina. Ahora se podrá acceder al controlador en la utilidad de administrador de ODBC.

Configura DSN para conexiones de MongoDB

A continuación, configura DSN para conexiones de MongoDB. Sigue los pasos a continuación.

  1. Abre el Administrador de fuentes de datos ODBC (64 bits) en tu máquina.

  2. Crea una nueva fuente de datos con el controlador ODBC de MongoDB con Simba (versión 2.03.22.1024).

  3. Completa estos campos:

    • Nombre de la fuente de datos: puede ser cualquier cosa, pero debe completarse, incluso si se utiliza temporalmente la conexión ODBC.

    • Server: el nombre del servidor.

    • Puerto: tu puerto de servidor (27018 para MongoDB integrado).

    • Base de datos: AlteryxService (o AlteryxGallery, según la base de datos que estés actualizando).

    • Mecanismo: SCRAM-SHA-256

    • Fuente de autenticación: coincide con el nombre de la base de datos de la entrada “d” anterior.

    • Nombre de usuario: nombre de usuario de la base de datos, generalmente usuario.

    • Contraseña: contraseña de la base de datos. Comprueba la configuración del sistema Alteryx para obtener la contraseña de MongoDB integrado.

  4. Selecciona Probar… para garantizar que la conexión se estableció correctamente.

  5. Selecciona Opciones avanzadas…

  6. Actualiza el valor del tamaño de columna binaria a 2147483647.

  7. En la sección Metadatos en Mecanismo, selecciona Archivo local.

  8. Selecciona Examinar… y selecciona el archivo de esquema apropiado ubicado en la carpeta esquema específica de la versión de MongoDB:

    • Para versiones hasta 2023.2:

      • Archivo de esquema: MongoDB_Schema_23.2.json

      • Ubicación de instalación del usuario: %appdata%\Alteryx\Samples\data\Enterprise Utilities\Server Usage Report\supporting_macros\SimbaMongoDB_SchemaFiles\MongoDB_Schema_23.2.json

      • Ubicación de instalación del administrador: %ProgramData%\Alteryx\Samples\data\Enterprise Utilities\Server Usage Report\supporting_macros\SimbaMongoDB_SchemaFiles\MongoDB_Schema_23.2.json

    • Para versiones 2024.1 y posteriores:

      • Archivo de esquema: MongoDB_Schema_24.1Plus.json

      • Ubicación de instalación del usuario: %appdata%\Alteryx\Samples\data\Enterprise Utilities\Server Usage Report\supporting_macros\SimbaMongoDB_SchemaFiles\MongoDB_Schema_24.1Plus.json

      • Ubicación de instalación del administrador: %ProgramData%\Alteryx\Samples\data\Enterprise Utilities\Server Usage Report\supporting_macros\SimbaMongoDB_SchemaFiles\MongoDB_Schema_24.1Plus.json

  9. Selecciona Abrir, luego, Aceptar y Aceptar de nuevo.

  10. Repite los pasos anteriores para la base de datos AlteryxService.

Crea conexiones de DCM para MongoDB

El siguiente paso es crear conexiones para MongoDB en el Administrador de conexiones de datos (DCM).

  1. Abre DCM. En Designer, ve a Archivo > Administrar conexiones.

  2. En la pestaña Fuentes de datos, selecciona + Nuevo y elige el mosaico de MongoDB.

  3. En el menú desplegable Tecnología, selecciona ODBC de MongoDB.

    • Nombre de la fuente de datos: ingresa el nombre de la fuente de datos AlteryxService de Mongo en la sección Configurar DSN para conexiones de MongoDB anterior.

    • DSN de ODBC: selecciona el DSN de ODBC de AlteryxService de MongoDB creado anteriormente.

  4. Selecciona Guardar y luego Conectar credencial.

  5. Completa estos campos:

    • Método de autenticación: nombre de usuario y contraseña de MongoDB

    • Credencial: crea una nueva credencial

    • Nombre de la credencial: nombre de tu elección (por ejemplo, MongoDB_AlteryxService_Local).

    • Almacén : DCM

    • Nombre de usuario: usuario

    • Contraseña: tu contraseña.

    • Mecanismo de autenticación: SCRAM-SHA-256

    • Fuente de autenticación: AlteryxService

    • Permitir conexión para SDK: sin marcar

  6. Selecciona Probar conexión. Si se establece correctamente, selecciona Crear y vincular.

  7. Repite estos pasos para la base de datos de AlteryxGallery.

Crea una conexión de DCM para la API de Server

  1. Abre DCM. En Designer, ve a Archivo > Administrar conexiones.

  2. En la pestaña Fuentes de datos, selecciona + Nuevo y elige el mosaico de Descargar.

    • Nombre de la fuente de datos: nombre de tu elección (por ejemplo, API de Server).

    • URL base: ingresa la URL base para tu API de Server. Esto termina con /webapi/.

      Ejemplo: https://CompanyServerName/webapi/

  3. Selecciona Guardar.

  4. Selecciona Conectar credencial.

  5. En el menú desplegable Método de autenticación, selecciona Nombre de usuario y contraseña.

  6. En el menú desplegable Credencial, selecciona Crear nueva credencial.

    • Nombre de la credencial: nombre de tu elección (por ejemplo, claves de la API de Server).

    • Almacén: selecciona DCM.

    • Nombre de usuario: ingresa la clave de acceso a la API que se encuentra en tu perfil de Gallery.

    • Contraseña: ingresa el secreto de acceso a la API que se encuentra en tu perfil de Gallery.

  7. Selecciona Crear y vincular.

(Opcional) Crea la caché de conexiones de DCM y bases de datos de salida

  1. Abre DCM. En Designer, ve a Archivo > Administrar conexiones.

  2. Selecciona + Nuevo y elige el mosaico de MongoDB.

  3. En el menú desplegable Tecnología, selecciona la base de datos deseada y termina de configurar la conexión.

(Opcional) Crea las tablas necesarias en las bases de datos de salida

Ejecuta las siguientes aplicaciones para crear las tablas necesarias en las bases de datos de salida. Este paso es opcional según las preferencias. También es opcional si la base de datos de la caché no se está utilizando o si los datos no se están enviando a las tablas de base de datos. Si se utiliza cualquiera de ellos, ejecuta la aplicación correspondiente.

  • Si utilizas una base de datos para almacenar en la caché los paquetes de flujo de trabajo descargados de Gallery, ejecuta Crear tablas de base de datos de caché (aplicación).

  • Si utilizas una base de datos para generar los datos finales en tablas, ejecuta Crear tablas de base de datos de salida (aplicación).

Ejecutar informe de uso de Alteryx Server

Sigue estos pasos para ejecutar el informe de uso de Server:

  1. Ingresa las credenciales creadas en los pasos anteriores:

    • Alteryx Gallery: conexión de DCM a la base de datos de AlteryxGallery.

    • Alteryx Service: conexión de DCM a la base de datos de AlteryxService.

    • Credenciales de la API: conexión de DCM a las credenciales de la API de Server.

    • Filtrar trabajos y resultados por fecha: restringe las consultas de tablas AS_Queue (trabajos) y AS_Results (mensajes de resultados) para que solo retrocedan a una fecha especificada.

    • Utilizar base de datos de flujo de trabajo almacenada en caché (opcional): almacena en caché las descargas del paquete de aplicación desde las llamadas API. Utiliza esta opción si tu Designer contiene muchos flujos de trabajo, ya que puede tardar mucho tiempo en descargar cada ejecución.

    • Salida del archivo Hyper de Tableau: define dónde deseas generar la salida del archivo Hyper de Tableau. Deja esta opción como predeterminada si esta es la primera ejecución para probar el libro de Tableau.

    • Salida a tablas de base de datos (opcional): utiliza la conexión de DCM para generar salida de datos en tablas separadas en tu propia base de datos.

    • Salida en archivos separados (opcional):

      • (Opcional) Selecciona una ubicación (carpeta) para guardar los archivos separados. Vacío = carpeta .\Output.

      • (Opcional) Ingresa el prefijo. Vacío = sin prefijo.

      • Elige el tipo de archivo (CSV o YXDB).

  2. Ejecuta el flujo de trabajo.

  3. Ve a la carpeta proporcionada para abrir el libro de Tableau y ver los datos. Si el archivo Hyper se envió a una ubicación diferente, vuelve a conectar la fuente de datos dentro de Tableau para ver tus datos.

Resolución de problemas

Revisa esta sección para ver problemas comunes y pasos de solución de problemas.

Comprueba los permisos

En primer lugar, asegúrate de que los permisos correctos estén establecidos en la interfaz de usuario de Alteryx Server para descargar flujos de trabajo:

  • En Server, ve Panel de administración > Configuración > Activos: asegúrate de que Desactivar descarga directa no esté seleccionado.

  • Los usuarios deben tener la casilla de verificación Otros pueden descargar este flujo de trabajo seleccionada en la configuración de cada flujo de trabajo. Esto está seleccionado de forma predeterminada, por lo que, a menos que desmarquen explícitamente esta casilla de verificación, el paquete de flujo de trabajo debe tener los permisos correctos.

  • El usuario que ejecuta el informe de uso de Server debe tener el acceso a la API activado para obtener tokens de API.

Notas adicionales de solución de problemas

Revisa los errores comunes y los pasos de resolución sugeridos a continuación.

500 No se encontró respuesta

Revisa este artículo de la Comunidad.

Informe de uso de Alteryx Server (8): PullServiceDetails (1483): Herramienta n.º 147: Error interno: Intento de leer más allá del final de un blob.

Comprueba la configuración avanzada del DSN de ODBC. El tamaño de columna binaria debe ser 2147483647.

Informe de uso de Alteryx Server (8): No se pudieron extraer los detalles del flujo de trabajo de Alteryx Server: HTTP/1.1 500 Error interno del servidor

Comprueba si el flujo de trabajo está dañado. Confirma que se pueda ejecutar en Server.

Informe de uso de Alteryx Server (8): No se pudieron extraer los detalles del flujo de trabajo de Alteryx Server: HTTP/1.1 403 Prohibido

Comprueba que el flujo de trabajo se pueda descargar y que la configuración global permita descargar flujos de trabajo. A continuación, revisa la configuración “Desactivar descarga directa” en Administración > Configuración de Server.

HTTP/1.1 404 o HTTP/1.1 401, o “RetrieveServerOAuthToken: la prueba “DownloadSucceeded” falló”

Comprueba que la URL base de la conexión de DCM es “http://localhost/webapi/” (ten en cuenta el sufijo /webapi y el final “/”, no utilices /Gallery/ aquí).

Confirma que la clave de acceso (nombre de usuario) y el secreto de acceso (contraseña) de la conexión de DCM sean correctos.

Comprueba que AlteryxService se esté ejecutando y puedes acceder a la documentación Gallery o Swagger (API). Si no es así, intenta reiniciar AlteryxService en “servicios”.

En esta sección: