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

Nesta página, descrevemos como usar o MConnect para gerar painéis do Looker Studio com dados coletados pelo Google Cloud Migration Center e pelo CAST.

Assista o 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 da Central de Migração e da análise estática de código de aplicativos realizada pela CAST Software. Em seguida, ele exporta os dados para o BigQuery e o Looker Studio para análise avançada.

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 nos recursos de computação.

Antes de começar

Antes de usar o MConnect, faça o seguinte:

  1. Crie uma Conta do Google e uma conta do Google Cloud .
  2. Crie um Google Cloud projeto e ative as APIs BigQuery e Migration Center.
  3. Instale a Google Cloud CLI na sua máquina local.
  4. Crie um relatório de Destaque da CAST chamado analysisResults.csv.

Preços

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

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, faça o seguinte:

  1. Se você usa o Linux, faça o download do binário mais recente. Para outras plataformas de SO, clone o repositório migrationcenter-utils e crie o MConnect na sua máquina local.

  2. 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 para criar e excluir tabelas no BigQuery no projeto que você quer usar.

Fazer upload dos recursos para o Migration Center

Faça upload dos recursos relacionados aos aplicativos no seu relatório do CAST para a Central de migração. Se você já fez 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 Central de migração. 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, é possível 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. É possível fazer isso na interface do Migration Center ou com a API.

Exportar relatórios do CAST e dados 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:

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

Criar visualizações no BigQuery

Com base nos 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

Você pode configurar o relatório gerado do Looker Studio de duas maneiras, conforme descrito nas seções a seguir.

  1. Copie o link obtido na etapa anterior para seu navegador da Web.
  2. 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:

  1. No Looker Studio, abra o relatório Central de migração / Análise do CAST.
  2. Clique em Mais opções.
  3. Clique em Fazer uma cópia > Copiar relatório.
  4. No novo relatório, clique em Recursos > Gerenciar fontes de dados adicionadas.
  5. Usando a fonte de dados chamada McCastReadinessCombined_vw, clique em Editar.
  6. Forneça o ID do projeto e do conjunto de dados usados na etapa anterior e escolha mccastreadinesscombined_vw.
  7. Clique em Reconectar e em Aplicar.
  8. Clique em Concluído e atualize a página.

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

Referência do MConnect

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

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 o Migration Center e dados do CAST.
export
Exporta dados do CAST para o BigQuery.
help
Ajuda sobre qualquer comando.

Flags

-h, --help
Ajuda para mconnect.
-t, --toggle
Mensagem de ajuda para alternância.
-v, --version
Versão do 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]

Exemplos

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

Flags

-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 já existentes.
--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 em todos os comandos. (Obrigatório)
--region
A região do Migration Center em que os grupos serão criados. (Obrigatório)

export

Exporta o relatório do CAST e os dados do Migration Center para o BigQuery. Por padrão, vamos presumir 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]

Exemplos

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

Flags

--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ça 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 da 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 os 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 o Migration Center e dados de 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 agrupados de recursos da Central de migração.
  • castreadiness_vw: mostra dados do arquivo de análise da CAST.
  • mccastreadinesscombined_vw: combina as duas visualizações anteriores. Essa visualização também é usada no modelo do Looker Studio.

Exemplos

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

Flags

--dataset
O ID do conjunto de dados do BigQuery em que as visualizações serão criadas. Use o mesmo conjunto de dados do comando de exportação. (Obrigatório)
-f, --force
Força 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 nas 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)