> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/documentation/pt-br/painel/instancias-do-produto.md).

# Instâncias do produto

Saiba como criar, configurar e gerenciar instâncias de produto no Oxylabs Dashboard.

Uma instância de produto é uma configuração específica de um serviço (por exemplo, Residential Proxies, Web API) que inclui um nome exclusivo, credenciais de autenticação e um limite de gastos opcional.

## Criando uma instância de produto

{% stepper %}
{% step %}

### Inicie a criação da instância

Clique em **+ Add product instance** na página Visão geral. Novos produtos podem ser ativados instantaneamente – sem gerente de conta ou tempo de espera.

Novos usuários são solicitados a criar sua instância de produto na primeira visita:

<img src="https://1214208351-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzrXw45naRpCZ0Ku9AjY1%2Fuploads%2FvYj084BtK5Fv5iZFW1Rl%2Funknown.png?alt=media&amp;token=92da1c3e-849f-4090-9bb9-1935781ac7e3" alt="" height="315" width="582">

Usuários existentes podem encontrar a opção de criação da instância como mostrado abaixo:

<img src="https://1214208351-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzrXw45naRpCZ0Ku9AjY1%2Fuploads%2F1sUwP5Gxm9XOTNrhb5mP%2Funknown.png?alt=media&amp;token=0890503c-a2cf-4f7e-a999-28d595cb7d05" alt="" height="251" width="610">
{% endstep %}

{% step %}

### Selecione um produto

Escolha um produto na lista. Os produtos são agrupados em categorias:

* **Coleta de dados** (Web API)
* **Proxies e soluções avançadas de proxy** (Residenciais, Móveis, Datacenter, ISP Proxies, Web Unblocker)
* **Navegadores** (Agent Browser)

<img src="https://1214208351-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzrXw45naRpCZ0Ku9AjY1%2Fuploads%2F1wgtNla3jsDbd68Qh43w%2Funknown.png?alt=media&amp;token=c281d677-ca76-4c0d-813d-82ca8f18725d" alt="" height="287" width="610">
{% endstep %}

{% step %}

### Defina o nome da instância e as credenciais

**Nome da instância**: Escolha um nome descritivo.

**Configurações de autenticação:**&#x20;

* **Nome de usuário e senha** (gerados automaticamente, a senha pode ser editada depois)
* **IPs permitidos** (uma lista de IPs confiáveis para autenticação)

<img src="https://1214208351-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzrXw45naRpCZ0Ku9AjY1%2Fuploads%2FNx6nKfC3LCCar43ykuhn%2Funknown.png?alt=media&amp;token=4b1886b9-1d4d-4d3f-adbe-7350ea3f1738" alt="" height="413" width="610">
{% endstep %}

{% step %}

### Configure limites e notificações (opcional)

Para limitar o uso na nova instância, defina um limite com:

**Tipo de limite**:

* `USD/EUR` (Monetário)
* `Resultados`
* `GB` (Tráfego)

**Período**: `Diário`, `Semanal`, `Mensal`, ou `Vitalício`

{% hint style="info" %}
**Tipo de limite** a escolha varia conforme o produto.
{% endhint %}

Depois, escolha uma **Ação para limite excedido**:

* **Desativar instância** quando o limite for atingido.
* **Enviar e-mail** alertas sem desativar a instância.

<img src="https://1214208351-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzrXw45naRpCZ0Ku9AjY1%2Fuploads%2F7eH6ntyBgTpEcc0o3KFf%2Funknown.png?alt=media&amp;token=821dc630-ef49-4ab2-b92d-abf8599ae691" alt="" height="256" width="610">

{% hint style="info" %}
Os limites da instância controlam os gastos apenas nessa instância específica. Eles são separados do saldo de crédito geral da sua conta – veja [Cobrança Baseada em Créditos](https://developers.oxylabs.io/documentation/pt-br/painel/cobranca-baseada-em-creditos.md) como o saldo compartilhado funciona.
{% endhint %}
{% endstep %}

{% step %}

### Concluir a configuração da instância

Clique em **Criar instância** para concluir a configuração.
{% endstep %}
{% endstepper %}

## Gerenciando instâncias

Clique em qualquer instância para abrir sua página de detalhes. A partir daí, você pode:

* Editar o nome da instância
* Ativar, desativar ou excluir a instância
* Ajustar limites
* Ver ou editar senhas
* Acessar exemplos de integração
* Ver estatísticas de uso e a barra de progresso do limite de gastos

<img src="https://1214208351-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzrXw45naRpCZ0Ku9AjY1%2Fuploads%2FmT6Evm1WmGyePNkbZxBg%2Funknown.png?alt=media&amp;token=7143d06f-e0c4-44a7-b23c-798acd521df2" alt="" height="525" width="624">

## Alertas granulares

O proprietário da equipe pode definir alertas de gastos no nível da `50%`, `80%`, ou `100%` instância para que você seja notificado antes que uma instância de produto ou sua conta geral atinja o limite.

{% hint style="info" %}
Por padrão, os alertas são definidos em `80%` e `100%` do limite do seu plano.
{% endhint %}

O proprietário da equipe pode gerenciar quem recebe esses alertas (endereços de e-mail dos destinatários) nas configurações de notificações por e-mail – veja [Configurações da equipe e da conta](https://developers.oxylabs.io/documentation/pt-br/painel/configuracoes-da-equipe-e-da-conta.md).

## Monitoramento de gastos e uso

### Gastos em tempo real

A barra superior na página Visão geral mostra os gastos em tempo real do ciclo de cobrança atual.

<img src="https://1214208351-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzrXw45naRpCZ0Ku9AjY1%2Fuploads%2FWSOjB8OPsD9ZC4cNzKuZ%2Funknown.png?alt=media&amp;token=a93773cb-3360-40ae-8ded-6f016e9f3811" alt="" height="88" width="624">

### Dados históricos

Na **Gastos** aba, veja dados históricos por **Produtos**, **Instâncias**, ou **Alvos**. Alterne entre `Por hora`, `Diário`, `Semanal`, ou `Mensal` visualizações para diferentes granularidades.

<img src="https://content.gitbook.com/content/zrXw45naRpCZ0Ku9AjY1/blobs/S27WuoQfnJ0ILEceFUvD/unknown.png" alt="" height="329" width="624">

### Uso

O **Uso** aba exibe taxas de sucesso, tempo de resposta e outras métricas por intervalo de tempo ou alvo, dependendo do produto escolhido.

<img src="https://1214208351-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzrXw45naRpCZ0Ku9AjY1%2Fuploads%2FZUfLxeMtJY5vWU1PUC2w%2Funknown.png?alt=media&amp;token=fb5a2bf1-a33f-466e-be2f-8afb928729cf" alt="" height="411" width="624">

Você também pode comparar detalhamentos de uso diários:

<img src="https://1214208351-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzrXw45naRpCZ0Ku9AjY1%2Fuploads%2FkzAnKryz6vG7MxweXNss%2Funknown.png?alt=media&amp;token=6de36fb6-658f-4e28-af95-8d3984d1ef16" alt="" height="151" width="624">

{% hint style="info" %}
Para extrair estatísticas de uso de forma programática em vez de visualizá-las no painel, consulte o [API do Dashboard](https://developers.oxylabs.io/documentation/pt-br/painel/dashboard-api.md).
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developers.oxylabs.io/documentation/pt-br/painel/instancias-do-produto.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
