diff --git a/docs/manual_tecnico.html b/docs/manual_tecnico.html new file mode 100644 index 0000000..895e5a2 --- /dev/null +++ b/docs/manual_tecnico.html @@ -0,0 +1,565 @@ + + + + + + OPHION - Manual Técnico + + + +

OPHION - Manual Técnico

+

Plataforma de Observabilidade com IA

+
+

1. Visão Geral

+

OPHION é uma plataforma de observabilidade open source que combina métricas, logs e traces em uma única solução, potencializada por inteligência artificial para monitoramento proativo e auto-healing.

+
+

2. Stack Tecnológico

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
CamadaTecnologiaFunção
API ServerGo 1.22Backend principal
DashboardNext.js + TypeScriptInterface web
CollectorOpenTelemetry CollectorIngestão de telemetria
DatabasePostgreSQLDados estruturados
Time SeriesClickHouseMétricas de alta performance
CacheRedisCache e filas
ContainerDocker ComposeOrquestração
+
+

3. Arquitetura do Sistema

+
┌─────────────────────────────────────────────────────────────────┐
+│                    APLICAÇÕES INSTRUMENTADAS                     │
+│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐   │
+│  │ Node.js │ │ Python  │ │  Java   │ │  .NET   │ │   Go    │   │
+│  └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘   │
+│       └───────────┴───────────┼───────────┴───────────┘         │
+│                               │ OTLP (4317/4318)                 │
+└───────────────────────────────┼─────────────────────────────────┘
+                                │
+┌───────────────────────────────┼─────────────────────────────────┐
+│ OPHION STACK                  ▼                                  │
+│  ┌─────────────────────────────────────────────────┐            │
+│  │         OpenTelemetry Collector                  │            │
+│  │         (receivers → processors → exporters)     │            │
+│  └─────────────────────────┬───────────────────────┘            │
+│                            │                                     │
+│  ┌────────────────┐       ▼        ┌────────────────┐           │
+│  │   Dashboard    │◄───► Server ◄──►│   PostgreSQL   │           │
+│  │   (Next.js)    │    (Go API)    │   ClickHouse   │           │
+│  │   :3000        │     :8080      │   Redis        │           │
+│  └────────────────┘                └────────────────┘           │
+│                                                                  │
+│  ┌────────────────────────────────────────────────┐             │
+│  │              AI Engine (Copilot)                │             │
+│  │    - Correlação de alertas                      │             │
+│  │    - Previsão de capacidade                     │             │
+│  │    - Auto-healing                               │             │
+│  └────────────────────────────────────────────────┘             │
+└─────────────────────────────────────────────────────────────────┘
+
+
+

4. Estrutura de Diretórios

+
ophion/
+├── cmd/
+│   ├── server/           # API Server (Go)
+│   └── agent/            # Agent de coleta
+├── internal/             # Código interno Go
+│   ├── api/              # Handlers HTTP
+│   ├── db/               # Repositórios
+│   ├── ai/               # Engine de IA
+│   └── telemetry/        # Processamento OTLP
+├── dashboard/            # Frontend Next.js
+│   ├── src/
+│   │   ├── app/          # App Router
+│   │   ├── components/   # UI Components
+│   │   └── lib/          # Utilitários
+│   └── package.json
+├── deploy/
+│   ├── docker/           # Docker configs
+│   │   └── otel-collector-config.yaml
+│   ├── remote-agent/     # Agent remoto
+│   └── instrumentation/  # Scripts de instrumentação
+├── examples/             # Exemplos por linguagem
+│   ├── otel-nodejs/
+│   ├── otel-python/
+│   └── docker/
+├── configs/              # Configurações
+├── docs/                 # Documentação
+├── instrument.sh         # Script de auto-instrumentação
+├── install.sh            # Instalador
+├── docker-compose.yml
+├── go.mod / go.sum
+└── server                # Binário compilado
+
+
+

5. Componentes Principais

+

5.1 OpenTelemetry Collector

+

Portas: +- 4317 - OTLP gRPC +- 4318 - OTLP HTTP

+

Pipeline:

+
receivers:
+  otlp:
+    protocols:
+      grpc:
+        endpoint: 0.0.0.0:4317
+      http:
+        endpoint: 0.0.0.0:4318
+
+processors:
+  batch:
+    timeout: 1s
+  memory_limiter:
+    limit_mib: 512
+
+exporters:
+  ophion:
+    endpoint: http://server:8080
+
+

5.2 Server (Go API)

+

Endpoints principais:

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
EndpointMétodoDescrição
/api/v1/tracesPOSTIngestão de traces
/api/v1/metricsPOSTIngestão de métricas
/api/v1/logsPOSTIngestão de logs
/api/v1/servicesGETLista serviços
/api/v1/alertsGET/POSTGerenciamento de alertas
/api/v1/ai/analyzePOSTAnálise por IA
+

5.3 Dashboard (Next.js)

+

Recursos: +- Service Map visual +- Trace waterfall +- Métricas em tempo real +- Logs agregados +- Alertas e notificações +- AI Copilot chat

+
+

6. Auto-Instrumentação

+

6.1 Script Universal

+
# Auto-detecta linguagem
+./instrument.sh <container-name>
+
+# Especifica linguagem
+./instrument.sh my-app nodejs
+./instrument.sh my-app python
+./instrument.sh my-app java
+./instrument.sh my-app dotnet
+
+

6.2 Suporte por Linguagem

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
LinguagemMétodoComplexidade
.NETAuto-instrumentationZero code
Node.jsAuto-instrumentationZero code
PythonAuto-instrumentationZero code
JavaJava AgentZero code
GoSDK (compile-time)Pequenas mudanças
PHPSDKPequenas mudanças
+

6.3 Variáveis de Ambiente

+
OTEL_EXPORTER_OTLP_ENDPOINT=http://ophion:4318
+OTEL_SERVICE_NAME=my-service
+OTEL_RESOURCE_ATTRIBUTES=deployment.environment=production
+
+
+

7. AI Engine

+

7.1 Funcionalidades

+ +

7.2 Integração OpenAI

+
OPENAI_API_KEY=sk-...
+AI_MODEL=gpt-4
+
+
+

8. Deploy

+

8.1 Quick Start (Docker)

+
git clone https://github.com/bigtux/ophion.git
+cd ophion
+docker compose up -d
+
+

8.2 Acessos

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ServiçoURLPorta
Dashboardhttp://localhost:30003000
APIhttp://localhost:80808080
OTLP gRPClocalhost:43174317
OTLP HTTPlocalhost:43184318
+

8.3 Produção

+
# Com install.sh
+./install.sh --production
+
+# Ou manualmente
+docker compose -f docker-compose.prod.yml up -d
+
+
+

9. Requisitos do Sistema

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
RecursoMínimoRecomendado
CPU2 cores4+ cores
RAM4 GB8+ GB
Disco20 GB SSD100+ GB SSD
Docker20.10+Latest
Docker Composev2+Latest
+
+

10. Configuração

+

10.1 Variáveis de Ambiente

+
# Server
+PORT=8080
+DATABASE_URL=postgres://user:pass@localhost:5432/ophion
+REDIS_URL=redis://localhost:6379
+CLICKHOUSE_URL=clickhouse://localhost:9000
+
+# Auth
+JWT_SECRET=your-secret
+AGENT_KEY=agent-secret-key
+
+# AI
+OPENAI_API_KEY=sk-...
+AI_ENABLED=true
+
+# Notifications
+TELEGRAM_BOT_TOKEN=...
+TELEGRAM_CHAT_ID=...
+
+

10.2 Configuração do Collector

+
# otel-collector-config.yaml
+receivers:
+  otlp:
+    protocols:
+      grpc:
+        endpoint: 0.0.0.0:4317
+      http:
+        endpoint: 0.0.0.0:4318
+
+processors:
+  batch:
+    timeout: 1s
+    send_batch_size: 1024
+
+exporters:
+  otlphttp:
+    endpoint: http://server:8080/api/v1
+
+service:
+  pipelines:
+    traces:
+      receivers: [otlp]
+      processors: [batch]
+      exporters: [otlphttp]
+
+
+

11. Segurança

+ +
+

12. Desenvolvimento

+
# Backend (Go)
+go run ./cmd/server
+
+# Frontend (Next.js)
+cd dashboard
+npm install
+npm run dev
+
+# Testes
+go test ./...
+
+
+

13. Troubleshooting

+ + + + + + + + + + + + + + + + + + + + + + + + + +
ProblemaSolução
Traces não aparecemVerificar OTEL_EXPORTER_OTLP_ENDPOINT
Dashboard lentoAumentar RAM do ClickHouse
Collector crashVerificar memory_limiter no config
Auth falhandoVerificar JWT_SECRET
+
+

14. Licença

+

AGPL-3.0 (Community Edition)

+
+

Documento gerado automaticamente - OPHION

+ + \ No newline at end of file diff --git a/docs/manual_tecnico.md b/docs/manual_tecnico.md new file mode 100644 index 0000000..f9e73e2 --- /dev/null +++ b/docs/manual_tecnico.md @@ -0,0 +1,352 @@ +# OPHION - Manual Técnico + +## Plataforma de Observabilidade com IA + +--- + +## 1. Visão Geral + +**OPHION** é uma plataforma de observabilidade open source que combina **métricas, logs e traces** em uma única solução, potencializada por **inteligência artificial** para monitoramento proativo e auto-healing. + +--- + +## 2. Stack Tecnológico + +| Camada | Tecnologia | Função | +|--------|------------|--------| +| API Server | Go 1.22 | Backend principal | +| Dashboard | Next.js + TypeScript | Interface web | +| Collector | OpenTelemetry Collector | Ingestão de telemetria | +| Database | PostgreSQL | Dados estruturados | +| Time Series | ClickHouse | Métricas de alta performance | +| Cache | Redis | Cache e filas | +| Container | Docker Compose | Orquestração | + +--- + +## 3. Arquitetura do Sistema + +``` +┌─────────────────────────────────────────────────────────────────┐ +│ APLICAÇÕES INSTRUMENTADAS │ +│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ +│ │ Node.js │ │ Python │ │ Java │ │ .NET │ │ Go │ │ +│ └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘ │ +│ └───────────┴───────────┼───────────┴───────────┘ │ +│ │ OTLP (4317/4318) │ +└───────────────────────────────┼─────────────────────────────────┘ + │ +┌───────────────────────────────┼─────────────────────────────────┐ +│ OPHION STACK ▼ │ +│ ┌─────────────────────────────────────────────────┐ │ +│ │ OpenTelemetry Collector │ │ +│ │ (receivers → processors → exporters) │ │ +│ └─────────────────────────┬───────────────────────┘ │ +│ │ │ +│ ┌────────────────┐ ▼ ┌────────────────┐ │ +│ │ Dashboard │◄───► Server ◄──►│ PostgreSQL │ │ +│ │ (Next.js) │ (Go API) │ ClickHouse │ │ +│ │ :3000 │ :8080 │ Redis │ │ +│ └────────────────┘ └────────────────┘ │ +│ │ +│ ┌────────────────────────────────────────────────┐ │ +│ │ AI Engine (Copilot) │ │ +│ │ - Correlação de alertas │ │ +│ │ - Previsão de capacidade │ │ +│ │ - Auto-healing │ │ +│ └────────────────────────────────────────────────┘ │ +└─────────────────────────────────────────────────────────────────┘ +``` + +--- + +## 4. Estrutura de Diretórios + +``` +ophion/ +├── cmd/ +│ ├── server/ # API Server (Go) +│ └── agent/ # Agent de coleta +├── internal/ # Código interno Go +│ ├── api/ # Handlers HTTP +│ ├── db/ # Repositórios +│ ├── ai/ # Engine de IA +│ └── telemetry/ # Processamento OTLP +├── dashboard/ # Frontend Next.js +│ ├── src/ +│ │ ├── app/ # App Router +│ │ ├── components/ # UI Components +│ │ └── lib/ # Utilitários +│ └── package.json +├── deploy/ +│ ├── docker/ # Docker configs +│ │ └── otel-collector-config.yaml +│ ├── remote-agent/ # Agent remoto +│ └── instrumentation/ # Scripts de instrumentação +├── examples/ # Exemplos por linguagem +│ ├── otel-nodejs/ +│ ├── otel-python/ +│ └── docker/ +├── configs/ # Configurações +├── docs/ # Documentação +├── instrument.sh # Script de auto-instrumentação +├── install.sh # Instalador +├── docker-compose.yml +├── go.mod / go.sum +└── server # Binário compilado +``` + +--- + +## 5. Componentes Principais + +### 5.1 OpenTelemetry Collector + +**Portas:** +- `4317` - OTLP gRPC +- `4318` - OTLP HTTP + +**Pipeline:** +```yaml +receivers: + otlp: + protocols: + grpc: + endpoint: 0.0.0.0:4317 + http: + endpoint: 0.0.0.0:4318 + +processors: + batch: + timeout: 1s + memory_limiter: + limit_mib: 512 + +exporters: + ophion: + endpoint: http://server:8080 +``` + +### 5.2 Server (Go API) + +**Endpoints principais:** + +| Endpoint | Método | Descrição | +|----------|--------|-----------| +| `/api/v1/traces` | POST | Ingestão de traces | +| `/api/v1/metrics` | POST | Ingestão de métricas | +| `/api/v1/logs` | POST | Ingestão de logs | +| `/api/v1/services` | GET | Lista serviços | +| `/api/v1/alerts` | GET/POST | Gerenciamento de alertas | +| `/api/v1/ai/analyze` | POST | Análise por IA | + +### 5.3 Dashboard (Next.js) + +**Recursos:** +- Service Map visual +- Trace waterfall +- Métricas em tempo real +- Logs agregados +- Alertas e notificações +- AI Copilot chat + +--- + +## 6. Auto-Instrumentação + +### 6.1 Script Universal + +```bash +# Auto-detecta linguagem +./instrument.sh + +# Especifica linguagem +./instrument.sh my-app nodejs +./instrument.sh my-app python +./instrument.sh my-app java +./instrument.sh my-app dotnet +``` + +### 6.2 Suporte por Linguagem + +| Linguagem | Método | Complexidade | +|-----------|--------|--------------| +| .NET | Auto-instrumentation | Zero code | +| Node.js | Auto-instrumentation | Zero code | +| Python | Auto-instrumentation | Zero code | +| Java | Java Agent | Zero code | +| Go | SDK (compile-time) | Pequenas mudanças | +| PHP | SDK | Pequenas mudanças | + +### 6.3 Variáveis de Ambiente + +```env +OTEL_EXPORTER_OTLP_ENDPOINT=http://ophion:4318 +OTEL_SERVICE_NAME=my-service +OTEL_RESOURCE_ATTRIBUTES=deployment.environment=production +``` + +--- + +## 7. AI Engine + +### 7.1 Funcionalidades + +- **Correlação de Alertas**: Agrupa alertas relacionados +- **Root Cause Analysis**: Identifica causa raiz +- **Previsão de Capacidade**: Prevê saturação de recursos +- **Auto-Healing**: Executa ações corretivas automáticas +- **Copilot**: Chat para consultas em linguagem natural + +### 7.2 Integração OpenAI + +```env +OPENAI_API_KEY=sk-... +AI_MODEL=gpt-4 +``` + +--- + +## 8. Deploy + +### 8.1 Quick Start (Docker) + +```bash +git clone https://github.com/bigtux/ophion.git +cd ophion +docker compose up -d +``` + +### 8.2 Acessos + +| Serviço | URL | Porta | +|---------|-----|-------| +| Dashboard | http://localhost:3000 | 3000 | +| API | http://localhost:8080 | 8080 | +| OTLP gRPC | localhost:4317 | 4317 | +| OTLP HTTP | localhost:4318 | 4318 | + +### 8.3 Produção + +```bash +# Com install.sh +./install.sh --production + +# Ou manualmente +docker compose -f docker-compose.prod.yml up -d +``` + +--- + +## 9. Requisitos do Sistema + +| Recurso | Mínimo | Recomendado | +|---------|--------|-------------| +| CPU | 2 cores | 4+ cores | +| RAM | 4 GB | 8+ GB | +| Disco | 20 GB SSD | 100+ GB SSD | +| Docker | 20.10+ | Latest | +| Docker Compose | v2+ | Latest | + +--- + +## 10. Configuração + +### 10.1 Variáveis de Ambiente + +```env +# Server +PORT=8080 +DATABASE_URL=postgres://user:pass@localhost:5432/ophion +REDIS_URL=redis://localhost:6379 +CLICKHOUSE_URL=clickhouse://localhost:9000 + +# Auth +JWT_SECRET=your-secret +AGENT_KEY=agent-secret-key + +# AI +OPENAI_API_KEY=sk-... +AI_ENABLED=true + +# Notifications +TELEGRAM_BOT_TOKEN=... +TELEGRAM_CHAT_ID=... +``` + +### 10.2 Configuração do Collector + +```yaml +# otel-collector-config.yaml +receivers: + otlp: + protocols: + grpc: + endpoint: 0.0.0.0:4317 + http: + endpoint: 0.0.0.0:4318 + +processors: + batch: + timeout: 1s + send_batch_size: 1024 + +exporters: + otlphttp: + endpoint: http://server:8080/api/v1 + +service: + pipelines: + traces: + receivers: [otlp] + processors: [batch] + exporters: [otlphttp] +``` + +--- + +## 11. Segurança + +- Autenticação JWT para dashboard +- API Key para agents (`AGENT_KEY`) +- TLS opcional para OTLP +- Isolamento de rede via Docker +- Logs de auditoria + +--- + +## 12. Desenvolvimento + +```bash +# Backend (Go) +go run ./cmd/server + +# Frontend (Next.js) +cd dashboard +npm install +npm run dev + +# Testes +go test ./... +``` + +--- + +## 13. Troubleshooting + +| Problema | Solução | +|----------|---------| +| Traces não aparecem | Verificar OTEL_EXPORTER_OTLP_ENDPOINT | +| Dashboard lento | Aumentar RAM do ClickHouse | +| Collector crash | Verificar memory_limiter no config | +| Auth falhando | Verificar JWT_SECRET | + +--- + +## 14. Licença + +AGPL-3.0 (Community Edition) + +--- + +*Documento gerado automaticamente - OPHION* diff --git a/docs/manual_tecnico.pdf b/docs/manual_tecnico.pdf new file mode 100644 index 0000000..8094829 Binary files /dev/null and b/docs/manual_tecnico.pdf differ diff --git a/docs/manual_vendas.html b/docs/manual_vendas.html new file mode 100644 index 0000000..8a43be3 --- /dev/null +++ b/docs/manual_vendas.html @@ -0,0 +1,453 @@ + + + + + + OPHION - Manual de Vendas + + + +

OPHION - Manual de Vendas

+

Observabilidade Inteligente para o Mundo Real

+
+

1. Proposta de Valor

+

OPHION é a primeira plataforma de observabilidade open source que combina métricas, logs e traces com inteligência artificial para não apenas monitorar, mas prever e resolver problemas automaticamente.

+
+

"Não apenas veja seus sistemas. Entenda-os."

+
+

O Problema de Observabilidade Hoje

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
DesafioImpacto no Negócio
Ferramentas fragmentadasTempo perdido alternando dashboards
Alertas sem contextoAlert fatigue, problemas ignorados
Diagnóstico manualHoras para encontrar root cause
Dashboards estáticosNão preveem problemas
Custos por volumeContas astronômicas (Datadog, New Relic)
+

A Diferença OPHION

+

Uma plataforma, toda telemetria (métricas, logs, traces)
+✅ IA que correlaciona alertas e identifica root cause
+✅ Previsão de capacidade antes do problema acontecer
+✅ Auto-healing para ações corretivas automáticas
+✅ Custo previsível — não cobra por volume

+
+

2. Público-Alvo

+

2.1 Equipes de SRE / Platform Engineering

+ +

2.2 DevOps / Infrastructure Teams

+ +

2.3 CTOs e VPs de Engineering

+ +

2.4 Startups em Crescimento

+ +

2.5 Empresas com Compliance

+ +
+

3. Funcionalidades

+

📊 Unified Telemetry

+

Uma única interface para tudo: +- Métricas: CPU, memória, latência, custom metrics +- Logs: Agregados, pesquisáveis, correlacionados +- Traces: Distributed tracing com waterfall

+

🗺️ Service Map

+

Visualize sua arquitetura em tempo real: +- Dependências entre serviços +- Latência por salto +- Detecção de gargalos +- Health status por serviço

+

🤖 AI Copilot

+

Inteligência artificial integrada: +- Chat em linguagem natural: "Por que o checkout está lento?" +- Correlação de alertas: Agrupa relacionados automaticamente +- Root Cause Analysis: Identifica a origem do problema +- Sugestões de correção: O que fazer para resolver

+

🔮 Predictive Analytics

+

Antecipe problemas: +- Previsão de saturação de recursos +- Detecção de anomalias +- Tendências de degradação +- Alertas proativos

+

⚡ Auto-Healing

+

Ações automáticas: +- Restart de containers +- Scale-up/down automático +- Rollback de deployments +- Notificações inteligentes

+

🔧 Auto-Instrumentação

+

Zero code para começar: +- Node.js, Python, Java, .NET +- Script único: ./instrument.sh my-app +- OpenTelemetry nativo +- Suporte a todas as linguagens populares

+

📈 SLO/SLI Management

+

Gerencie objetivos de serviço: +- Definição de SLOs +- Error budgets +- Burn rate alerts +- Relatórios de compliance

+

🔔 Alerting Inteligente

+

Alertas que fazem sentido: +- Correlação para reduzir ruído +- Escalation automático +- Integração: Telegram, Slack, PagerDuty +- Silenciamento inteligente

+
+

4. Benefícios

+

Para SRE/DevOps

+

MTTR 10x menor: Root cause em segundos, não horas
+✅ Alert fatigue eliminado: IA agrupa e prioriza
+✅ Troubleshooting visual: Service map + traces
+✅ Menos toil: Auto-healing reduz intervenções manuais

+

Para a Empresa

+

Custo previsível: Sem surpresas na fatura
+✅ Uptime melhorado: Previsão de problemas
+✅ Compliance: Dados on-premise, auditáveis
+✅ ROI rápido: Implementação em horas, não semanas

+

Para Desenvolvedores

+

Debug em produção: Traces detalhados
+✅ Contexto completo: Logs + traces correlacionados
+✅ Zero config: Auto-instrumentação
+✅ Ownership: Veja o impacto do seu código

+
+

5. Casos de Uso

+

Caso 1: E-commerce em Black Friday

+
+

Um e-commerce com 500k requests/min usa OPHION para monitorar a Black Friday. O AI Copilot detecta degradação no serviço de pagamentos 15 minutos antes de virar problema. Auto-healing escala o serviço automaticamente. Zero downtime, R$ 2M em vendas salvas.

+
+

Caso 2: Fintech com Compliance

+
+

Uma fintech precisa de observabilidade mas não pode enviar dados para cloud pública. OPHION roda on-premise, com logs criptografados e trilha de auditoria completa. Compliance SOC 2 atendido.

+
+

Caso 3: Startup Escalonando

+
+

Uma startup cresceu de 5 para 50 microserviços em 1 ano. O service map do OPHION mostra dependências que ninguém documentou. Root cause analysis reduz MTTR de 4h para 10 minutos. Equipe de 3 pessoas gerencia tudo.

+
+

Caso 4: Migração para Kubernetes

+
+

Uma empresa migra para K8s e perde visibilidade. OPHION com auto-instrumentação cobre todos os pods sem mudar código. Observabilidade completa em 1 dia.

+
+
+

6. Comparativo de Mercado

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureOPHIONDatadogGrafana CloudNew Relic
Métricas + Logs + Traces
AI CopilotParcial
Auto-Healing
Correlação IA💰💰💰💰
Previsão de Capacidade💰💰💰
Open SourceParcial
On-Premise
Auto-instrumentação💰💰
Custo por volume❌ Fixo💰💰💰💰💰💰💰💰
+
+

7. Modelo de Implantação

+

Community Edition (Open Source)

+ +

Enterprise Edition

+ +

Managed (Cloud)

+ +
+

8. Integrações

+

Plataformas

+ +

Linguagens (Auto-instrumentação)

+ +

Alerting

+ +

CI/CD

+ +

Standards

+ +
+

9. Implementação

+

Timeline Típico

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FaseDuraçãoAtividade
Setup1hdocker compose up
Instrumentação1-2hAuto-instrument serviços críticos
Configuração2-4hAlertas, dashboards, SLOs
Produção1 semanaRefinamento e ajustes
+

Pré-requisitos

+ +
+

10. Próximos Passos

+
    +
  1. Demo: Veja OPHION em ação (15 min)
  2. +
  3. POC: Instale em ambiente de teste
  4. +
  5. Pilot: Instrumente 3-5 serviços críticos
  6. +
  7. Rollout: Expanda para toda infraestrutura
  8. +
  9. Optimize: Configure AI e auto-healing
  10. +
+
+

11. Suporte

+ +
+

OPHION - Observabilidade que pensa por você

+ + \ No newline at end of file diff --git a/docs/manual_vendas.md b/docs/manual_vendas.md new file mode 100644 index 0000000..c87e69d --- /dev/null +++ b/docs/manual_vendas.md @@ -0,0 +1,256 @@ +# OPHION - Manual de Vendas + +## Observabilidade Inteligente para o Mundo Real + +--- + +## 1. Proposta de Valor + +**OPHION** é a primeira plataforma de observabilidade open source que combina **métricas, logs e traces** com **inteligência artificial** para não apenas monitorar, mas **prever e resolver problemas automaticamente**. + +> *"Não apenas veja seus sistemas. Entenda-os."* + +### O Problema de Observabilidade Hoje + +| Desafio | Impacto no Negócio | +|---------|-------------------| +| Ferramentas fragmentadas | Tempo perdido alternando dashboards | +| Alertas sem contexto | Alert fatigue, problemas ignorados | +| Diagnóstico manual | Horas para encontrar root cause | +| Dashboards estáticos | Não preveem problemas | +| Custos por volume | Contas astronômicas (Datadog, New Relic) | + +### A Diferença OPHION + +✅ **Uma plataforma, toda telemetria** (métricas, logs, traces) +✅ **IA que correlaciona** alertas e identifica root cause +✅ **Previsão de capacidade** antes do problema acontecer +✅ **Auto-healing** para ações corretivas automáticas +✅ **Custo previsível** — não cobra por volume + +--- + +## 2. Público-Alvo + +### 2.1 Equipes de SRE / Platform Engineering +- Responsáveis por uptime e performance +- Precisam de visibilidade cross-service +- Buscam reduzir MTTR + +### 2.2 DevOps / Infrastructure Teams +- Gerenciam dezenas/centenas de serviços +- Precisam de troubleshooting rápido +- Querem automatizar operações + +### 2.3 CTOs e VPs de Engineering +- Buscam reduzir custos de observabilidade +- Precisam de métricas de SLA/SLO +- Querem visão executiva de saúde + +### 2.4 Startups em Crescimento +- Infraestrutura ficando complexa +- Budget limitado para ferramentas enterprise +- Precisam escalar observabilidade + +### 2.5 Empresas com Compliance +- Precisam manter dados on-premise +- Regulamentações de soberania de dados +- Auditoria e rastreabilidade + +--- + +## 3. Funcionalidades + +### 📊 Unified Telemetry +Uma única interface para tudo: +- **Métricas**: CPU, memória, latência, custom metrics +- **Logs**: Agregados, pesquisáveis, correlacionados +- **Traces**: Distributed tracing com waterfall + +### 🗺️ Service Map +Visualize sua arquitetura em tempo real: +- Dependências entre serviços +- Latência por salto +- Detecção de gargalos +- Health status por serviço + +### 🤖 AI Copilot +Inteligência artificial integrada: +- **Chat em linguagem natural**: "Por que o checkout está lento?" +- **Correlação de alertas**: Agrupa relacionados automaticamente +- **Root Cause Analysis**: Identifica a origem do problema +- **Sugestões de correção**: O que fazer para resolver + +### 🔮 Predictive Analytics +Antecipe problemas: +- Previsão de saturação de recursos +- Detecção de anomalias +- Tendências de degradação +- Alertas proativos + +### ⚡ Auto-Healing +Ações automáticas: +- Restart de containers +- Scale-up/down automático +- Rollback de deployments +- Notificações inteligentes + +### 🔧 Auto-Instrumentação +Zero code para começar: +- Node.js, Python, Java, .NET +- Script único: `./instrument.sh my-app` +- OpenTelemetry nativo +- Suporte a todas as linguagens populares + +### 📈 SLO/SLI Management +Gerencie objetivos de serviço: +- Definição de SLOs +- Error budgets +- Burn rate alerts +- Relatórios de compliance + +### 🔔 Alerting Inteligente +Alertas que fazem sentido: +- Correlação para reduzir ruído +- Escalation automático +- Integração: Telegram, Slack, PagerDuty +- Silenciamento inteligente + +--- + +## 4. Benefícios + +### Para SRE/DevOps + +✅ **MTTR 10x menor**: Root cause em segundos, não horas +✅ **Alert fatigue eliminado**: IA agrupa e prioriza +✅ **Troubleshooting visual**: Service map + traces +✅ **Menos toil**: Auto-healing reduz intervenções manuais + +### Para a Empresa + +✅ **Custo previsível**: Sem surpresas na fatura +✅ **Uptime melhorado**: Previsão de problemas +✅ **Compliance**: Dados on-premise, auditáveis +✅ **ROI rápido**: Implementação em horas, não semanas + +### Para Desenvolvedores + +✅ **Debug em produção**: Traces detalhados +✅ **Contexto completo**: Logs + traces correlacionados +✅ **Zero config**: Auto-instrumentação +✅ **Ownership**: Veja o impacto do seu código + +--- + +## 5. Casos de Uso + +### Caso 1: E-commerce em Black Friday +> Um e-commerce com 500k requests/min usa OPHION para monitorar a Black Friday. O AI Copilot detecta degradação no serviço de pagamentos 15 minutos antes de virar problema. Auto-healing escala o serviço automaticamente. **Zero downtime, R$ 2M em vendas salvas**. + +### Caso 2: Fintech com Compliance +> Uma fintech precisa de observabilidade mas não pode enviar dados para cloud pública. OPHION roda on-premise, com logs criptografados e trilha de auditoria completa. **Compliance SOC 2 atendido**. + +### Caso 3: Startup Escalonando +> Uma startup cresceu de 5 para 50 microserviços em 1 ano. O service map do OPHION mostra dependências que ninguém documentou. Root cause analysis reduz MTTR de 4h para 10 minutos. **Equipe de 3 pessoas gerencia tudo**. + +### Caso 4: Migração para Kubernetes +> Uma empresa migra para K8s e perde visibilidade. OPHION com auto-instrumentação cobre todos os pods sem mudar código. **Observabilidade completa em 1 dia**. + +--- + +## 6. Comparativo de Mercado + +| Feature | OPHION | Datadog | Grafana Cloud | New Relic | +|---------|--------|---------|---------------|-----------| +| Métricas + Logs + Traces | ✅ | ✅ | ✅ | ✅ | +| **AI Copilot** | ✅ | ❌ | ❌ | Parcial | +| **Auto-Healing** | ✅ | ❌ | ❌ | ❌ | +| **Correlação IA** | ✅ | 💰💰 | ❌ | 💰💰 | +| **Previsão de Capacidade** | ✅ | 💰💰 | ❌ | 💰 | +| Open Source | ✅ | ❌ | Parcial | ❌ | +| On-Premise | ✅ | ❌ | ❌ | ❌ | +| Auto-instrumentação | ✅ | 💰 | ❌ | 💰 | +| **Custo por volume** | ❌ Fixo | 💰💰💰 | 💰💰 | 💰💰💰 | + +--- + +## 7. Modelo de Implantação + +### Community Edition (Open Source) +- Todas as funcionalidades core +- Self-hosted +- Suporte via comunidade +- Licença AGPL-3.0 + +### Enterprise Edition +- SLA garantido +- Suporte dedicado +- Funcionalidades avançadas de compliance +- Multi-tenancy + +### Managed (Cloud) +- OPHION gerenciado +- SLA 99.9% +- Backups automáticos +- Updates gerenciados + +--- + +## 8. Integrações + +### Plataformas +- Kubernetes, Docker, AWS, GCP, Azure + +### Linguagens (Auto-instrumentação) +- Node.js, Python, Java, .NET, Go, PHP + +### Alerting +- Telegram, Slack, PagerDuty, OpsGenie, Email + +### CI/CD +- GitHub Actions, GitLab CI, Jenkins + +### Standards +- OpenTelemetry, Prometheus, Jaeger + +--- + +## 9. Implementação + +### Timeline Típico + +| Fase | Duração | Atividade | +|------|---------|-----------| +| Setup | 1h | docker compose up | +| Instrumentação | 1-2h | Auto-instrument serviços críticos | +| Configuração | 2-4h | Alertas, dashboards, SLOs | +| Produção | 1 semana | Refinamento e ajustes | + +### Pré-requisitos +- Docker 20.10+ +- 4GB RAM mínimo +- Acesso aos serviços a monitorar + +--- + +## 10. Próximos Passos + +1. **Demo**: Veja OPHION em ação (15 min) +2. **POC**: Instale em ambiente de teste +3. **Pilot**: Instrumente 3-5 serviços críticos +4. **Rollout**: Expanda para toda infraestrutura +5. **Optimize**: Configure AI e auto-healing + +--- + +## 11. Suporte + +- 📚 Documentação: docs.ophion.io +- 💬 Comunidade: Discord +- 📧 Enterprise: contato@ophion.io + +--- + +*OPHION - Observabilidade que pensa por você* + diff --git a/docs/manual_vendas.pdf b/docs/manual_vendas.pdf new file mode 100644 index 0000000..0580715 Binary files /dev/null and b/docs/manual_vendas.pdf differ