Administración de los servicios de Azure Cognitive Search en Azure PortalService administration for Azure Cognitive Search in the Azure portal

Azure Cognitive Search es un servicio de búsqueda basado en la nube totalmente administrado que se utiliza para la creación de una experiencia de búsqueda enriquecida en aplicaciones personalizadas.Azure Cognitive Search is a fully managed, cloud-based search service used for building a rich search experience into custom apps. En este artículo se tratan las tareas de administración de servicios que se pueden realizar en Azure Portal para un servicio de búsqueda que ya se haya aprovisionado.This article covers the service administration tasks that you can perform in the Azure portal for a search service that you've already provisioned. Administración de servicios es ligero por diseño y se limita a las siguientes tareas:Service administration is lightweight by design, limited to the following tasks:

  • Administrar el acceso a las claves de API que se usan para el acceso de lectura o escritura a su servicio.Manage access to the api-keys used for read or write access to your service.
  • Ajustar la capacidad de servicio, mediante el cambio de la asignación de particiones y réplicas.Adjust service capacity by changing the allocation of partitions and replicas.
  • Supervisar el uso de recursos, en relación con los límites máximos de su nivel de servicio.Monitor resource usage, relative to maximum limits of your service tier.

Tenga en cuenta que actualizar no aparece como una tarea administrativa.Notice that upgrade is not listed as an administrative task. Dado que los recursos se asignan cuando se aprovisiona el servicio, mover a otro nivel requiere un nuevo servicio.Because resources are allocated when the service is provisioned, moving to a different tier requires a new service. Consulte Creación de un servicio Azure Cognitive Search para más información.For details, see Create an Azure Cognitive Search service.

Puede supervisar el volumen de las consultas y otras métricas y usar esa información para ajustar el servicio y así obtener tiempos de respuesta más rápidos.You can monitor query volume and other metrics, and use those insights to adjust your service for faster response times. Para más información, vea Supervisar el uso y las métricas de consultas y Rendimiento y optimización.For more information, see Monitor usage and query metrics and Performance and optimization.

Derechos de administradorAdministrator rights

El aprovisionamiento o la retirada del propio servicio los puede realizar un administrador o coadministrador de una suscripción de Azure.Provisioning or decommissioning the service itself can be done by an Azure subscription administrator or co-administrator.

Dentro de un servicio, cualquier persona con acceso a la dirección URL del servicio y una clave de API de administración tiene acceso de lectura y escritura al servicio.Within a service, anyone with access to the service URL and an admin api-key has read-write access to the service. El acceso de lectura y escritura ofrece capacidad para agregar, eliminar o modificar objetos de servidor, incluidos claves de API, índices, indizadores, orígenes de datos, programaciones y asignaciones de roles, tal y como se implementa a través de roles definidos por RBAC.Read-write access provides the ability to add, delete, or modify server objects, including api-keys, indexes, indexers, data sources, schedules, and role assignments as implemented through RBAC-defined roles.

Toda la interacción del usuario con Azure Cognitive Search se encuadra en de uno de estos modos: acceso de lectura y escritura al servicio (derechos de administrador) o acceso de solo lectura al servicio (derechos de consulta).All user interaction with Azure Cognitive Search falls within one of these modes: read-write access to the service (administrator rights), or read-only access to the service (query rights). Para más información, consulte Administración de las claves de API.For more information, see Manage the api-keys.

Registro e información del sistemaLogging and system information

Azure Cognitive Search no expone los archivos de registro de un servicio individual ni a través del portal ni de interfaces de programación.Azure Cognitive Search does not expose log files for an individual service either through the portal or programmatic interfaces. En el nivel básico, y en los superiores, Microsoft supervisa que todos los servicios de Azure Cognitive Search tengan una disponibilidad del 99,9 % por contrato de nivel de servicio (SLA).At the Basic tier and above, Microsoft monitors all Azure Cognitive Search services for 99.9% availability per service level agreements (SLA). Si el servicio es lento o el rendimiento de las solicitudes no llega a los umbrales del SLA, los equipos de soporte técnico revisan los archivos de registro a los que pueden acceder y solucionan el problema.If the service is slow or request throughput falls below SLA thresholds, support teams review the log files available to them and address the issue.

En términos de información general acerca del servicio, hay varias formas de obtener información:In terms of general information about your service, you can obtain information in the following ways:

Supervisar el uso de recursosMonitor resource usage

En el panel, la supervisión de recursos se limita a la información que se muestra en el panel de servicios y algunas métricas que puede obtener al consultar el servicio.In the dashboard, resource monitoring is limited to the information shown in the service dashboard and a few metrics that you can obtain by querying the service. En el panel de servicios, en la sección Uso, podrá determinar rápidamente si los niveles de recursos de partición son adecuados para su aplicación.On the service dashboard, in the Usage section, you can quickly determine whether partition resource levels are adequate for your application. Puede aprovisionar recursos externos, como la supervisión de Azure, si desea capturar y persistir eventos registrados.You can provision external resources, such as Azure monitoring, if you want to capture and persist logged events. Para más información, consulte Supervisión de Azure Cognitive Search.For more information, see Monitoring Azure Cognitive Search.

Al usar la API de REST del servicio de búsqueda, puede obtener un recuento de los documentos e índices mediante programación:Using the search service REST API, you can get a count on documents and indexes programmatically:

Interrupciones de servicio y recuperación ante desastresDisaster recovery and service outages

Aunque podemos recuperar los datos, Azure Cognitive Search no proporciona conmutación por error instantánea del servicio si se produce una interrupción en centro de datos o el clúster.Although we can salvage your data, Azure Cognitive Search does not provide instant failover of the service if there is an outage at the cluster or data center level. Si se produce un error en un clúster del centro de datos, el equipo de operaciones lo detectará y trabajará para restaurar el servicio.If a cluster fails in the data center, the operations team will detect and work to restore service. Experimentará tiempo de inactividad durante la restauración del servicio, pero puede solicitar créditos del servicio para compensar la falta de disponibilidad de servicio según el Acuerdo de Nivel de Servicio (SLA).You will experience downtime during service restoration, but you can request service credits to compensate for service unavailability per the Service Level Agreement (SLA).

Si se requiera continuidad del servicio, en caso de errores catastróficos fuera de control de Microsoft, debe aprovisionar un servicio adicional en una región diferente e implementar una estrategia de replicación geográfica para asegurarse de que los índices sean totalmente redundantes en todos los servicios.If continuous service is required in the event of catastrophic failures outside of Microsoft’s control, you could provision an additional service in a different region and implement a geo-replication strategy to ensure indexes are fully redundant across all services.

Los clientes que usen indizadores para rellenar y actualizar índices pueden controlar la recuperación ante desastres mediante indizadores geográficos que aprovechan el mismo origen de datos.Customers who use indexers to populate and refresh indexes can handle disaster recovery through geo-specific indexers leveraging the same data source. Dos servicios en regiones diferentes, donde cada uno ejecuta un indizador, pueden indexar desde el mismo origen de datos para lograr redundancia geográfica.Two services in different regions, each running an indexer, could index the same data source to achieve geo-redundancy. Si indexa desde orígenes de datos que también tienen redundancia geográfica, tenga en cuenta que los indexadores de Azure Cognitive Search solo pueden realizar una indexación incremental a partir de las réplicas principales.If you are indexing from data sources that are also geo-redundant, be aware that Azure Cognitive Search indexers can only perform incremental indexing from primary replicas. En un evento de conmutación por error, asegúrese de que el indizador apunte de nuevo a la nueva réplica principal.In a failover event, be sure to re-point the indexer to the new primary replica.

Si no utiliza indizadores, usaría el código de aplicación para enviar objetos y datos a distintos servicios de búsqueda en paralelo.If you do not use indexers, you would use your application code to push objects and data to different search services in parallel. Para más información, consulte Estrategias de implementación y procedimientos recomendados de Azure Cognitive Search.For more information, see Performance and optimization in Azure Cognitive Search.

Copia de seguridad y restauraciónBackup and restore

Dado que Azure Cognitive Search no es una solución de almacenamiento de datos principal, no se proporciona un mecanismo formal para realizar procesos de copias de seguridad y restauración automáticos.Because Azure Cognitive Search is not a primary data storage solution, we do not provide a formal mechanism for self-service backup and restore. Sin embargo, puede usar el ejemplo de código index-backup-restore de este repositorio de ejemplo .NET de Azure Cognitive Search para realizar la copia de seguridad de la definición de índice y una instantánea en una serie de archivos JSON y, después, usar esos archivos para restaurar el índice, en caso de que sea necesario.However, you can use the index-backup-restore sample code in this Azure Cognitive Search .NET sample repo to backup your index definition and snapshot to a series of JSON files, and then use these files to restore the index, if needed. Esta herramienta también se puede usar para mover índices entre niveles de servicio.This tool can also move indexes between service tiers.

De lo contrario, el código de aplicación que se usa para crear y rellenar un índice es la opción de restauración de facto si elimina por error un índice.Otherwise, your application code used for creating and populating an index is the de facto restore option if you delete an index by mistake. Para volver a generar un índice, elimínelo (si existe), vuelva a crear el índice en el servicio y cárguelo de nuevo recuperando los datos del almacén de datos principal.To rebuild an index, you would delete it (assuming it exists), recreate the index in the service, and reload by retrieving data from your primary data store.

Escalado o reducción verticalScale up or down

Cada uno de los servicios de búsqueda se inicia con una cantidad mínima de una réplica y una partición.Every search service starts with a minimum of one replica and one partition. Si ha iniciado sesión en un nivel que proporciona recursos dedicados, haga clic en el icono ESCALA del panel de servicios para ajustar el uso de recursos.If you signed up for a tier that provides dedicated resources, click the SCALE tile in the service dashboard to adjust resource usage.

Al agregar una capacidad mediante cualquiera de los recursos, el servicio los usa automáticamente.When you add capacity through either resource, the service uses them automatically. No es necesario que haga nada más, pero hay un ligero retraso antes de materializarse el impacto del nuevo recurso.No further action is required on your part, but there is a slight delay before the impact of the new resource is realized. El aprovisionamiento de los recursos adicionales puede tardar 15 minutos, o más.It can take 15 minutes or more to provision additional resources.

Adición de réplicasAdd replicas

La adición de réplicas permiten un aumento de las consultas por segundo (QPS) o la consecución de una alta disponibilidad.Increasing queries per second (QPS) or achieving high availability is done by adding replicas. Cada réplica tiene una copia de un índice, por lo que la adición de una réplica más se traduce en que hay un índice más disponible para controlar solicitudes de consulta del servicio.Each replica has one copy of an index, so adding one more replica translates to one more index available for handling service query requests. Para lograr una alta disponibilidad, se requieren un mínimo de tres réplicas (para más información, consulte Escalado de niveles de recursos para cargas de trabajo de indexación y consulta en Azure Search ).A minimum of 3 replicas are required for high availability (see Capacity Planning for details).

Un servicio de búsqueda con más réplicas puede equilibrar la carga de solicitudes de consulta sobre un número de índices mayor.A search service having more replicas can load balance query requests over a larger number of indexes. Una vez especificado un nivel del volumen de consultas, el rendimiento de las consultas va a ser más rápido cuando haya más copias del índice disponible para ofrecer la solicitud.Given a level of query volume, query throughput is going to be faster when there are more copies of the index available to service the request. En caso de experimentar una latencia de consulta, puede esperar que se produzca un impacto positivo en el rendimiento una vez que las réplicas adicionales estén en línea.If you are experiencing query latency, you can expect a positive impact on performance once the additional replicas are online.

Aunque el rendimiento de las consultas aumente a medida que agrega réplicas, esto no lo dobla ni triplica precisamente a medida que agrega réplicas a su servicio.Although query throughput goes up as you add replicas, it does not precisely double or triple as you add replicas to your service. Todas las aplicaciones de búsqueda están sujetas a factores externos que pueden afectar al rendimiento de las consultas.All search applications are subject to external factors that can impinge on query performance. Las consultas complejas y la latencia de red son dos factores que contribuyen a la existencia de variaciones en los tiempos de respuesta de las consultas.Complex queries and network latency are two factors that contribute to variations in query response times.

Adición de particionesAdd partitions

La mayoría de las aplicaciones de servicio tienen una necesidad integrada de más réplicas, en lugar de particiones.Most service applications have a built-in need for more replicas rather than partitions. En los casos donde se requiere un mayor número de documentos, puede agregar particiones si se registró en un servicio Estándar.For those cases where an increased document count is required, you can add partitions if you signed up for Standard service. El nivel Básico no proporciona particiones adicionales.Basic tier does not provide for additional partitions.

En el nivel Estándar, las particiones se agregan en múltiplos de 12 (concretamente 1, 2, 3, 4, 6 o 12).At the Standard tier, partitions are added in multiples of 12 (specifically, 1, 2, 3, 4, 6, or 12). Se trata de un artefacto de particionamiento.This is an artifact of sharding. Un índice se crea en 12 particiones de base de datos, que pueden almacenarse en su totalidad en una partición o dividirse equitativamente en 2, 3, 4, 6 o 12 particiones (una partición de base de datos por partición).An index is created in 12 shards, which can all be stored on 1 partition or equally divided into 2, 3, 4, 6, or 12 partitions (one shard per partition).

Eliminación de réplicasRemove replicas

Tras períodos de elevados volúmenes de consultas, puede usar el control deslizante para reducir las réplicas después de que se hayan normalizado las cargas de consultas de búsqueda (por ejemplo, tras finalizar las ventas navideñas).After periods of high query volumes, you can use the slider to reduce replicas after search query loads have normalized (for example, after holiday sales are over). No es necesario que haga nada más.There are no further steps required on your part. Al reducir el recuento de réplicas, las máquinas virtuales se abandonan en el centro de datos.Lowering the replica count relinquishes virtual machines in the data center. Ahora, sus operaciones de ingesta de consultas y datos se ejecutarán en menos VM que antes.Your query and data ingestion operations will now run on fewer VMs than before. El requisito mínimo es una réplica.The minimum requirement is one replica.

Eliminación de particionesRemove partitions

A diferencia de la eliminación de réplicas, que no requiere que haga nada más, es posible que tenga que hacer algo si usa más almacenamiento del que se puede reducir.In contrast with removing replicas, which requires no extra effort on your part, you might have some work to do if you are using more storage than can be reduced. Por ejemplo, si su solución usa tres particiones, la reducción de su tamaño a una o dos particiones generará un error si el nuevo espacio de almacenamiento es inferior al requerido para hospedar el índice.For example, if your solution is using three partitions, downsizing to one or two partitions will generate an error if the new storage space is less than required for hosting your index. Como cabría esperar, las opciones con las que cuenta son eliminar índices o documentos en un índice asociado para liberar espacio o mantener la configuración actual.As you might expect, your choices are to delete indexes or documents within an associated index to free up space, or keep the current configuration.

No existe un método de detección que indique qué particiones de índice se almacenan en particiones concretas.There is no detection method that tells you which index shards are stored on specific partitions. Cada partición proporciona un espacio de almacenamiento de aproximadamente 25 MB, de modo que será necesario reducirlo a un tamaño al que pueda ajustarse su número de particiones.Each partition provides approximately 25 GB in storage, so you will need to reduce storage to a size that can be accommodated by the number of partitions you have. Si quiere volver a una partición, las 12 particiones deberán ajustarse.If you want to revert to one partition, all 12 shards will need to fit.

Para ayudar en una futura planificación, es posible que quiera comprobar el espacio de almacenamiento (usando Obtención de estadísticas de índice) para ver cuánto usó en realidad.To help with future planning, you might want to check storage (using Get Index Statistics) to see how much you actually used.

Pasos siguientesNext steps

Una vez que comprenda los conceptos de administración del servicio, considere la posibilidad de utilizar PowerShell para automatizar las tareas.Once you understand the concepts behind service administration, consider using PowerShell to automate tasks.

También se recomienda revisar el artículo sobre rendimiento y optimización.We also recommend reviewing the performance and optimization article.