Esta página foi traduzida pela API Cloud Translation.

Criar painéis avançados com o CAST e o Looker Studio

Esta página descreve como usar o MConnect para gerar painéis do Looker Studio com base em dados coletados com o Google Cloud Migration Center e o CAST.

Assista ao tutorial para começar a usar o MConnect.

Visão geral

O MConnect é uma interface de linha de comando que ajuda a mesclar informações do Migration Center e da análise de código estático de aplicativos realizados pelo CAST Software. Em seguida, os dados são exportados para o BigQuery e para o Looker Studio para análise avançada de dados.

Ele ajuda a modernizar aplicativos comparando várias dimensões da transformação, como nível de esforço, nível de prontidão do código e impacto do recurso de computação.

Antes de começar

Antes de usar o MConnect, siga estas etapas:

Crie uma Conta do Google e uma conta do Google Cloud .
Crie um Google Cloud projeto e ative a API BigQuery e a Migration Center.
- Para a Central de migração, consulte Primeiros passos com a Central de migração.
- Para o BigQuery, consulte Primeiros passos com o BigQuery.
Instale a Google Cloud CLI na sua máquina local.
Crie um relatório CAST Highlight com o nome analysisResults.csv.

Preços

Você pode receber cobranças pelo BigQuery, Looker Studio e CAST, de acordo com os respectivos preços.

Gerar um painel para seus dados

As seções a seguir explicam como gerar um painel do Looker Studio para seus dados do CAST.

Configurar a ferramenta

Antes de usar o MConnect, siga estas etapas:

Se você usa Linux, faça o download da versão binária mais recente. Para outras plataformas de SO, clone o repositório migrationcenter-utils e crie o MConnect na sua máquina local.
Faça a autenticação na Google Cloud CLI:
```
gcloud init
gcloud auth application-default login
```
Verifique se a conta que você está usando tem as permissões necessárias para criar e excluir grupos no Migration Center e criar e excluir tabelas no BigQuery no projeto que você quer usar.

Fazer upload dos recursos no Migration Center

Faça o upload dos recursos relacionados aos aplicativos no seu relatório CAST para a Migration Center. Se você já realizou uma descoberta de inventário para sua infraestrutura, pule esta etapa.

Para mais informações, consulte Iniciar uma descoberta de recursos.

Criar grupos na Central de migração

Use os aplicativos identificados no relatório do CAST para criar grupos na Migration Center. Na máquina local, execute o comando a seguir:

mconnect create-groups --path=ANALYSIS_PATH --project=PROJECT_ID --region=REGION

Substitua:

ANALYSIS_PATH: o caminho para o arquivo de relatório do CAST.
PROJECT_ID: o ID do seu projeto.
REGION: a região que você está usando para o Migration Center. Somente us-central1 e europe-west1 são aceitos.

Depois de criar os grupos, você pode filtrá-los no Migration Center usando o rótulo mconnect.

Atribuir recursos a grupos

No Migration Center, atribua seus recursos aos grupos de aplicativos correspondentes. Você pode fazer isso na interface da Central de migração ou com a API.

Exportar dados do relatório CAST e do Migration Center para o BigQuery

Exporte os dados do seu relatório do CAST para o BigQuery:

mconnect export --path=ANALYSIS_PATH --project=PROJECT_ID --region=REGION

O comando realiza as seguintes ações:

Ele cria um novo banco de dados no BigQuery chamado mcCast.
Ela cria uma nova tabela no BigQuery chamada castResults e a preenche com os dados do relatório CAST.
Ele exporta os dados do Migration Center para o BigQuery criando três tabelas chamadas assets, groups e preference_sets.

Criar visualizações no BigQuery

Com os dados enviados para o BigQuery, crie as visualizações correspondentes:

mconnect create-views --project=PROJECT_ID --dataset=mcCast

O comando cria três visualizações:

migrationcenterinfra_vw
castreadiness_vw
mccastreadinesscombined_vw

A saída desse comando fornece um link para um relatório do Looker Studio usando a visualização mccastreadinesscombined_vw.

Configurar o relatório do Looker Studio

É possível configurar o relatório gerado do Looker Studio de duas maneiras, conforme descrito nas seções a seguir.

Usando o link fornecido

Copie o link recebido na etapa anterior para o navegador da Web.
Clique em Salvar e compartilhar e em Confirmar e salvar.

Copiar os dados manualmente

Se o link fornecido estiver corrompido, configure manualmente o relatório do Looker Studio usando seus dados:

No Looker Studio, abra o relatório Migration Center / CAST Analysis.
Clique em Mais opções.
Clique em Fazer uma cópia > Copiar relatório.
No novo relatório, clique em Recursos > Gerenciar fontes de dados adicionadas.
Usando a fonte de dados McCastReadinessCombined_vw, clique em Editar.
Informe o ID do projeto e do conjunto de dados usados na etapa anterior e escolha mccastreadinesscombined_vw.
Clique em Reconectar e em Aplicar.
Clique em Concluído e atualize a página.

Isso cria um novo relatório chamado Migration Center / CAST Analysis usando seus dados.

Referência do MConnect

As seções a seguir fornecem os comandos MConnect disponíveis e as flags deles.

mconnect

Uso: mconnect [command] [args] [flags]

Comandos disponíveis

create-groups: Cria um grupo para cada aplicativo CAST no Migration Center e adiciona um rótulo "mconnect" a ele.
create-views: Cria três visualizações no BigQuery usando dados do Migration Center e do CAST.
export: Exporta dados do CAST para o BigQuery.
help: Ajuda sobre qualquer comando.

Sinalizações

-h, --help: Ajuda para mconnect.
-t, --toggle: Mensagem de ajuda para ativar.
-v, --version: Versão para mconnect.

create-groups

Cria um grupo para cada aplicativo CAST no Migration Center e adiciona o rótulo "mconnect" a ele.

Uso: mconnect create-groups path project region [flags]

Examples

mconnect create-groups --path=path/to/cast/analysisResults.csv --project=my-mc-project-id --region=my-region1

mconnect create-groups --path=path/to/cast/analysisResults.csv --project=my-mc-project-id --region=my-region1 --ignore-existing-groups=true

Sinalizações

-h, --help: Ajuda para create-groups.
-i, --ignore-existing-groups: Continue se o mconnect estiver tentando criar um grupo que já existe no Migration Center. Se definido como "true", o rótulo "mconnect" também será adicionado a todos os grupos que já existem.
--path: O caminho do arquivo CSV que contém o relatório do CAST (analysisResults.csv). (Obrigatório)
--project: O ID do projeto em que os grupos do Migration Center serão criados. Use o mesmo ID do projeto para todos os comandos. (Obrigatório)
--region: A região do Migration Center em que os grupos serão criados. (Obrigatório)

export

Exporta dados do relatório CAST e do Migration Center para o BigQuery. Por padrão, será presumido que o projeto e a região usados para o Migration Center e o BigQuery são os mesmos.

Uso: mconnect export path project region dataset [flags]

Examples

mconnect export --path=path/to/cast/analysisResults.csv --project=my-project-id --region=my-region1 # the default dataset will be set to 'mcCast'.
mconnect export --path=path/to/cast/analysisResults.csv --project=my-project-id --region=my-region1 --dataset=dataset-id 
mconnect export --path=path/to/cast/analysisResults.csv --project=my-project-id --region=my-region1 --dataset=dataset-id  --force=true
mconnect export --path=path/to/cast/analysisResults.csv --project=my-project-id --region=my-region1 --dataset=dataset-id --mc-project=my-mc-project-id --mc-region=my-mc-region

Sinalizações

--dataset: O ID do conjunto de dados para exportar os dados. Se o conjunto de dados não existir, ele será criado. Se não for especificado, o nome padrão será "mcCast". Use o mesmo conjunto de dados para todos os comandos.
-f, --force: Forçar a exportação dos dados mesmo que as tabelas de destino existam. A operação vai excluir todo o conteúdo das tabelas originais.
-h, --help: Ajuda para exportação.
--path: O caminho do arquivo CSV do relatório CAST (analysisResults.csv). (Obrigatório)
--project: O ID do projeto do BigQuery para exportar os dados. (Obrigatório)
--region: A região do BigQuery em que o conjunto de dados e as tabelas serão criados. (Obrigatório)

Flags ocultas

--mc-project: O ID do projeto do Migration Center usado para exportar dados para o BigQuery.
--mc-region: A região da Central de migração de onde os dados serão exportados.

create-views

Cria três visualizações no BigQuery usando dados do Migration Center e do CAST. Fornece um link para um relatório do Looker Studio usando a visualização mccastreadinesscombined_vw.

Uso: mconnect create-views project dataset [flags]

Visualizações criadas

migrationcenterinfra_vw: mostra dados de recursos agrupados da Central de migração.
castreadiness_vw: mostra dados do arquivo de análise CAST.
mccastreadinesscombined_vw: combina as duas visualizações anteriores. Essa visualização também é usada no modelo do Looker Studio.

Examples

mconnect create-views --project=my-project-id --dataset=dataset-id
mconnect create-views --project=my-project-id --dataset=dataset-id --force=true

Sinalizações

--dataset: O ID do conjunto de dados do BigQuery para criar as visualizações. Use o mesmo conjunto de dados do comando de exportação. (Obrigatório)
-f, --force: Forçar a criação de visualizações, mesmo que apenas uma das visualizações de destino exista. A operação vai substituir todo o conteúdo das visualizações antigas.
-h, --help: Ajuda para create-views.
--project: O ID do projeto do BigQuery em que as visualizações serão criadas. (Obrigatório)