Liberte o seu Instana para observar novas tecnologias
Você pode configurar o Instana para observar novos sistemas ou tecnologias usando o painel personalizado e os recursos de definição de eventos do Instana, juntamente com seus recursos de integração com o OpenTelemetry. Ao usar painéis públicos, eventos e pacotes de integração reutilizáveis, você mesmo pode implementar as soluções de observabilidade necessárias.
Explorando os pacotes de integração
Pesquise painéis reutilizáveis e definições de eventos que estão agrupados em pacotes de integração em um registro central, como o npmjs. Você pode analisar esses pacotes quanto à sua funcionalidade, etapas de instalação e outros detalhes antes de integrá-los ao seu ambiente Instana. A revisão dos pacotes garante uma adoção mais rápida dos novos recursos de observabilidade. IBM, juntamente com clientes e parceiros comerciais, fornecem seus pacotes de integração que você pode baixar e importar para aprimorar os recursos de monitoramento. A tabela a seguir fornece alguns exemplos de pacotes disponíveis:
| Nome | Descrição | Link |
|---|---|---|
| demonstração de telemetria aberta | O pacote de integração Instana usado para demonstrar o monitoramento do aplicativo de demonstração OpenTelemetry, uma versão Instana do projeto opentelemetry-demo bifurcado da comunidade. | demonstração de telemetria aberta |
| ir | O pacote de integração Instana usado para oferecer suporte ao monitoramento Go. | ir |
| Node.js | O pacote de integração Instana utilizado para suportar o monitoramento Node.js. | Node.js |
Baixando, importando e exportando painéis e definições de eventos
Como os painéis reutilizáveis e as definições de eventos são agrupados em pacotes de integração e estão disponíveis publicamente, você pode escolher os pacotes que oferecem suporte aos sistemas ou tecnologias que deseja observar. Baixe os pacotes necessários e importe-os para seus ambientes existentes do Instana. A importação dos pacotes amplia imediatamente os recursos do seu ambiente Instana para oferecer suporte à observabilidade de novos sistemas ou tecnologias.
Você pode usar a ferramenta de linha de comando, CLI do Instana para gerenciamento de pacotes de integração, para baixar, importar e exportar os pacotes de integração. Com essa ferramenta, você pode gerenciar o ciclo de vida do pacote, incluindo os painéis reutilizáveis e a definição de eventos. Para baixar a versão mais recente da ferramenta, consulte a página de lançamento do gerenciamento de pacotes de integração da CLI do Instana.
Para obter mais detalhes, consulte a página de documentação da CLI para exemplos de uso e comandos suportados.
Baixando painéis e definições de eventos
Para baixar um pacote de integração incluindo os painéis reutilizáveis e a definição de eventos usando a ferramenta, você deve especificar o nome do pacote. Veja o seguinte comando de exemplo para baixar um pacote chamado @instana-integration/go:
$ stanctl-integration download --package @instana-integration/go
Por padrão, a ferramenta cria um subdiretório no diretório de trabalho atual como diretório raiz para armazenar todos os pacotes de integração baixados. Você também pode especificar seu próprio diretório raiz para os pacotes usando a --location opção. Por exemplo, o comando a seguir baixa o pacote no diretório ./my-packagesraiz:
$ stanctl-integration download --package @instana-integration/go --location ./my-packages
Importação de painéis e definição de eventos
Depois que o pacote de integração for baixado para o seu computador local, você poderá usar a ferramenta para importar os painéis e as definições de eventos para qualquer ambiente existente do Instana. Você deve fornecer o endereço do servidor Instana e o token API usando as opções correspondentes ao executar a ferramenta. O token API é necessário porque a ferramenta chama uma série de APIs Instana para concluir a importação dos painéis e da definição de eventos. Consulte o seguinte exemplo:
$ stanctl-integration import --package @instana-integration/go \
--server $INSTANA_SERVER \
--token $API_TOKEN
Você pode especificar o diretório usando --location a opção. Por exemplo:
$ stanctl-integration import --package @instana-integration/go --location ./my-packages \
--server $INSTANA_SERVER \
--token $API_TOKEN
Sharing custom
dashboards publicly with all users and API tokenshabilitada. Para confirmar, abra o menu de navegação Instana e vá para Configurações > Configurações da equipe > Tokens do API. Em seguida, na página Tokens do API, selecione o token que você está usando para a importação. Na caixa de diálogo Editar token API, localize a seção Permissões do proprietário e certifique-se de que Sharing custom
dashboards publicly with all users and API tokens o item esteja ativado.Especificando valores de parâmetros para os painéis
Alguns painéis podem ter parâmetros em suas definições incluídos no pacote de integração. Isso ocorre porque alguns valores que aparecem nas definições do painel podem ainda não estar determinados quando o responsável pela manutenção do painel define o painel. Você pode verificar a página inicial do pacote para ver se algum parâmetro está incluído neste pacote. Ao importar esses painéis usando a ferramenta, você pode especificar os valores reais para esses parâmetros usando --set a opção, e essa opção pode ser usada várias vezes. Por exemplo:
$ stanctl-integration import --package @instana-integration/go \
--server $INSTANA_SERVER \
--token $API_TOKEN \
--set key1=value1 \
--set key2=value2
Exportação de painéis e definição de eventos
Além de baixar e importar, a CLI Instana para gerenciamento de pacotes de integração também oferece suporte à exportação de painéis e definições de eventos de um ambiente Instana existente. Para exportar painéis e definições de eventos, você deve fornecer o endereço do servidor Instana, um token API válido e pelo menos uma --include opção que especifique o tipo de ativo (painel ou evento). Além do tipo de ativo, você deve especificar o título ou a identificação para identificar o elemento específico que deseja exportar. A ferramenta usa as APIs Instana para recuperar os ativos correspondentes e os salva localmente em um formato portátil. Veja o exemplo a seguir, em que painéis e definições de eventos são exportados por meio da correspondência de um título:
$ stanctl-integration export --server $INSTANA_SERVER \
--token $API_TOKEN \
--include type=dashboard title="dashboardTitle"
Como alternativa, se você souber o ID de um painel ou evento, poderá exportá-lo diretamente especificando o ID. Consulte o seguinte exemplo:
$ stanctl-integration export --server $INSTANA_SERVER \
--token $API_TOKEN \
--include type=event id=eventID