- Información general
- Requisitos
- Instalación
- Comprobaciones de requisitos previos
- Descarga de los paquetes de instalación
- clúster uipathctl
- mantenimiento del clúster de uipathctl
- uipathctl cluster maintenance disable
- uipathctl cluster maintenance enable
- uipathctl cluster maintenance is-enabled
- uipathctl cluster migration
- uipathctl cluster migration export
- uipathctl cluster migration import
- uipathctl cluster migration run
- actualización del clúster de uipathctl
- configuración de uipathctl
- uipathctl config add-host-admin
- uipathctl config additional-ca-certificates
- uipathctl config additional-ca-certificates get
- uipathctl config additional-ca-certificates update
- Alertas de configuración de uipathctl
- Complemento de alertas de configuración de uipathctl
- uipathctl config alerts remove-email
- uipathctl config alerts update-email
- uipathctl config argocd
- uipathctl config argocd ca-certificates
- uipathctl config argocd ca-certificates get
- uipathctl config argocd ca-certificates update
- uipathctl config argocd generate-dex-config
- uipathctl config argocd generate-rbac
- uipathctl config argocd registry
- uipathctl config argocd registry get
- uipathctl config argocd registry update
- uipathctl config enable-basic-auth
- orchestrator de configuración de uipathctl
- get-config de uipathctl config del orquestador
- uipathctl config orchestrator update-config
- uipathctl config saml-certificates get
- uipathctl config saml-certificates rotate
- uipathctl config saml-certificates update
- uipathctl config tls-certificates
- uipathctl config tls-certificates get
- uipathctl config tls-certificates update
- uipathctl config token-signing-certificates
- uipathctl config token-signing-certificates get
- uipathctl config token-signing-certificates rotate
- uipathctl config token-signing-certificates update
- salud de uipathctl
- Paquete de salud de uipathctl
- comprobación de estado de uipathctl
- uipathctl health diagnose
- uipathctl health test
- manifiesto de uipathctl
- uipathctl manifest apply
- uipathctl manifest diff
- uipathctl manifest get
- uipathctl manifest get-revision
- lista de manifiesto de aplicaciones de uipathctl
- uipathctl manifest list-revisions
- uipathctl manifest render
- prerrequisito de uipathctl
- uipathctl prereq create
- uipathctl prereq run
- recurso uipathctl
- informe de recursos uipathctl
- instantánea de uipathctl
- copia de seguridad de instantánea de uipathctl
- uipathctl snapshot backup create
- uipathctl snapshot backup disable
- uipathctl snapshot backup enable
- uipathctl snapshot delete
- uipathctl snapshot list
- uipathctl snapshot restore
- uipathctl snapshot restore create
- uipathctl snapshot restore delete
- uipathctl snapshot restore history
- uipathctl snapshot restore logs
- versión de uipathctl
- Después de la instalación
- Migración y actualización
- Actualizar Automation Suite en EKS / AKS
- Paso 1: Mover los datos de la organización de identidad de independiente a Automation Suite
- Paso 2: restaurar la base de datos del producto independiente
- Paso 3: Realizar una copia de seguridad de la base de datos de la plataforma en Automation Suite
- Paso 4: Fusionar organizaciones en Automation Suite
- Paso 5: actualizar las cadenas de conexión de los productos migrados
- Paso 6: migrar el Orchestrator independiente
- Paso 7: migrar Insights independiente
- Paso 8: eliminar el tenant predeterminado
- B) Migración de tenant único
- Migrar de Automation Suite en Linux a Automation Suite en EKS / AKS
- Supervisión y alertas
- Administración de clústeres
- Configuración específica del producto
- Uso de la herramienta de configuración de Orchestrator
- Configurar parámetros de Orchestrator
- Configuración de Orchestrator
- Configurar AppSettings
- Configurar el tamaño máximo de la solicitud
- Anular la configuración de almacenamiento a nivel de clúster
- Guardar los registros del robot en Elasticsearch
- Configurar almacenes de credenciales
- Configurar clave de cifrado por tenant
- Solución de problemas
Guardar los registros del robot en Elasticsearch
Orchestrator está configurado de forma predeterminada para almacenar registros del robot en la base de datos. Sin embargo, si quieres cambiar este almacenamiento a Elasticsearch, hay disponible un proceso de configuración básico: simplemente proporciona la URL, el nombre de usuario y la contraseña requeridos. Esta configuración debería ser suficiente para la mayoría de los casos. Para una mayor personalización, puede aprovechar el mecanismo de configuración avanzada además de la configuración básica.
Si optas por esta configuración, permites que se escriban registros del robot en el destino de Elasticsearch en lugar de en la base de datos, y configura Orchestrator para recuperar los registros de Elasticsearch.
input.json
.
La configuración básica admite la versión 7.x de Elasticsearch. Para Elasticsearch 8.x, debes usar la configuración avanzada.
orchestrator.orchestrator_robot_logs_elastic
:
Parámetro |
Descripción |
---|---|
|
Configuración de la sección Elasticsearch. Este contiene las siguientes propiedades:
uri , username , password .
|
|
La dirección de la instancia de Elasticsearch que debe utilizarse. Debe proporcionarse en forma de URI. Si se facilita, también se requieren el nombre de usuario y la contraseña. |
|
El nombre de usuario de Elasticsearch que se utiliza para la autenticación. |
|
La contraseña de Elasticsearch que se utiliza para la autenticación. |
input.json
para agregar la sección orchestrator_robot_logs_elastic
en orchestrator
.
{
...
"orchestrator": {
...
"orchestrator_robot_logs_elastic": {
"elastic_uri": "uri",
"elastic_auth_username": "user",
"elastic_auth_password": "pass"
}
...
}
...
}
{
...
"orchestrator": {
...
"orchestrator_robot_logs_elastic": {
"elastic_uri": "uri",
"elastic_auth_username": "user",
"elastic_auth_password": "pass"
}
...
}
...
}
uipathctl
para aplicar la configuración, utiliza el siguiente comando:
uipathctl manifest apply input.json --only orchestrator --versions versions.json
uipathctl manifest apply input.json --only orchestrator --versions versions.json
Para acceder a los ajustes de configuración avanzados, primero debe completar la configuración básica. Este proceso te permite personalizar las propiedades del destino NLog que se comunica con Elasticsearch. Sin embargo, la redirección de los registros del robot requiere ajustes adicionales. Estos ajustes necesarios se realizan a través de la configuración básica.
Cualquier cambio que realice según los siguientes pasos b puede afectar negativamente a la funcionalidad y la estabilidad de todo el sistema. Solo es recomendable realizar cambios si comprende sus consecuencias.
La configuración avanzada le permite personalizar completamente su destino NLog.config:
-
Sigue los pasos de configuración básicos .
-
Edita los parámetros de muestra
nlog.json
para actualizar el destinorobotElasticBuffer
con la configuración deseada. Consulta las siguientes secciones para ver ejemplos denlog.json
. -
Actualice los
nlog.json
parámetros:uipathctl config orchestrator update-config --nlog-config nlog.json
uipathctl config orchestrator update-config --nlog-config nlog.json
robotElasticBuffer
. Puedes modificar cualquier propiedad de este destino utilizando el archivo nlog.json
personalizado. No es necesario proporcionar la configuración de destino completa; en su lugar, añada o actualice solo los valores deseados.
Ejemplo de configuración de Elasticsearch 7.x
uri
, requireAuth
, username
y password
, ya que están establecidos en el paso de configuración básica.
{
"Nlog": {
"targets": {
"robotElasticBuffer": {
"flushTimeout": 1000,
"bufferSize": 1000,
"slidingTimeout": false,
"target": {
"uri": "https://elastic.example.com:9200",
"requireAuth": true,
"username": "elastic-user",
"password": "elastic-password",
"index": "${event-properties:item=indexName}-${date:format=yyyy.MM}",
"documentType": "logEvent",
"includeAllProperties": true,
"layout": "${message}",
"excludedProperties": "agentSessionId,tenantId,indexName"
}
}
}
}
}
{
"Nlog": {
"targets": {
"robotElasticBuffer": {
"flushTimeout": 1000,
"bufferSize": 1000,
"slidingTimeout": false,
"target": {
"uri": "https://elastic.example.com:9200",
"requireAuth": true,
"username": "elastic-user",
"password": "elastic-password",
"index": "${event-properties:item=indexName}-${date:format=yyyy.MM}",
"documentType": "logEvent",
"includeAllProperties": true,
"layout": "${message}",
"excludedProperties": "agentSessionId,tenantId,indexName"
}
}
}
}
}
Ejemplo de configuración de Elasticsearch 8.x
uri
, requireAuth
, username
y password
, ya que están establecidos en el paso de configuración básica.
{
"Nlog": {
"targets": {
"robotElasticBuffer": {
"flushTimeout": 1000,
"bufferSize": 1000,
"slidingTimeout": false,
"target": {
"uri": "https://elastic.example.com:9200",
"requireAuth": true,
"username": "elastic-user",
"password": "elastic-password",
"index": "${event-properties:item=indexName}-${date:format=yyyy.MM}",
"documentType": "",
"includeAllProperties": true,
"layout": "${message}",
"excludedProperties": "agentSessionId,tenantId,indexName"
}
}
}
}
}
{
"Nlog": {
"targets": {
"robotElasticBuffer": {
"flushTimeout": 1000,
"bufferSize": 1000,
"slidingTimeout": false,
"target": {
"uri": "https://elastic.example.com:9200",
"requireAuth": true,
"username": "elastic-user",
"password": "elastic-password",
"index": "${event-properties:item=indexName}-${date:format=yyyy.MM}",
"documentType": "",
"includeAllProperties": true,
"layout": "${message}",
"excludedProperties": "agentSessionId,tenantId,indexName"
}
}
}
}
}
Esta sección proporciona información adicional sobre cómo proporcionar la configuración personalizada a Orchestrator.
uipathctl config orchestrator
.
Configuración de Orchestrator
appsettings
o para NLog se carga desde varios archivos de configuración que se cargan uno tras otro. Cada nuevo archivo cargado sobrescribe las claves de los anteriores. El orden en que se cargan los archivos es:
-
archivo de configuración integrado de la imagen de Orchestrator
-
Mapa de configuración de
orchestrator
-
orchestrator
secreto -
Mapa de configuración de
orchestrator-customconfig
appsettings
integrado configura Orchestrator para leer los registros de robots de este destino cuando se necesiten para mostrarlos. El archivo de configuración integrado de NLog también contiene robotElasticBuffer
destino, parcialmente configurado y no utilizado.
orchestrator
los gestiona ArgoCD a través del gráfico de helm. Cada vez que ArgoCD sincroniza la aplicación, estas configuraciones se regeneran usando los parámetros y valores actuales para la aplicación orchestrator
ArgoCD.
orchestrator
se actualizan para proporcionar la configuración final requerida para habilitar robotElasticBuffer
.
orchestrator-customconfig
. Cada valor nuevo o modificado se fusiona en la configuración existente, pero los valores no se pueden eliminar (se pueden establecer vacíos pero no eliminarse por completo).
Configuración predeterminada de NLog
robotElasticBuffer
preconfigurado.
{
"NLog": {
"targets": {
"robotElasticBuffer": {
"type": "BufferingWrapper",
"flushTimeout": 5000,
"target": {
"type": "ElasticSearch",
"name": "robotElastic",
"requireAuth": false,
"uri": "",
"username": "",
"password": "",
"index": "${event-properties:item=indexName}-${date:format=yyyy.MM}",
"documentType": "logEvent",
"includeAllProperties": true,
"layout": "${message}",
"excludedProperties": "agentSessionId,tenantId,indexName"
}
},
}
}
}
{
"NLog": {
"targets": {
"robotElasticBuffer": {
"type": "BufferingWrapper",
"flushTimeout": 5000,
"target": {
"type": "ElasticSearch",
"name": "robotElastic",
"requireAuth": false,
"uri": "",
"username": "",
"password": "",
"index": "${event-properties:item=indexName}-${date:format=yyyy.MM}",
"documentType": "logEvent",
"includeAllProperties": true,
"layout": "${message}",
"excludedProperties": "agentSessionId,tenantId,indexName"
}
},
}
}
}
Configuración personalizada de Orchestrator a través de uipathctl
Para ver más información sobre la actualización de la configuración personalizada de Orchestrator, ejecuta el siguiente comando:
uipathctl config orchestrator --help
uipathctl config orchestrator --help
Salida:
Configure orchestrator custom config
Usage:
uipathctl config orchestrator [command]
Available Commands:
get-config Get the current orchestrator custom config
update-config Update orchestrator config
Flags:
-h, --help help for orchestrator
Global Flags:
--context string name of the kubeconfig context to use
--kubeconfig string kubectl configuration file (default: ~/.kube/config)
--log-format string log format. one of [text,json] (default "text")
--log-level string set log level. one of [trace,debug,info,error] (default "error")
-q, --quiet suppress all output except for errors and warnings
--timeout duration timeout of the command (default 1h0m0s)
Configure orchestrator custom config
Usage:
uipathctl config orchestrator [command]
Available Commands:
get-config Get the current orchestrator custom config
update-config Update orchestrator config
Flags:
-h, --help help for orchestrator
Global Flags:
--context string name of the kubeconfig context to use
--kubeconfig string kubectl configuration file (default: ~/.kube/config)
--log-format string log format. one of [text,json] (default "text")
--log-level string set log level. one of [trace,debug,info,error] (default "error")
-q, --quiet suppress all output except for errors and warnings
--timeout duration timeout of the command (default 1h0m0s)