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

Nesta página, descrevemos como usar o MConnect para gerar painéis do Data 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 do Migration Center 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 Data Studio para análise de dados 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 projeto Google Cloud e ative as APIs BigQuery e Migration Center.
  3. Instale a Google Cloud CLI na sua máquina local.
  4. Crie um relatório do CAST Highlight chamado analysisResults.csv.

Preços

Você pode receber cobranças pelo BigQuery, Data Studio e 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 Data 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 o Migration Center. 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 no Migration Center

Use os aplicativos identificados no seu relatório do CAST para criar grupos no 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 do 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. Isso pode ser feito 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. Ele cria uma nova tabela no BigQuery chamada castResults e a preenche com os dados do relatório do CAST.
  3. 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 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 Data Studio usando a visualização mccastreadinesscombined_vw.

Configurar o relatório do Data Studio

É possível configurar o relatório gerado do Data 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 Data Studio usando seus dados:

  1. No Data Studio, abra o relatório Migration Center / 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 uma etiqueta "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 a ele o rótulo "mconnect".

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 para 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 dele para o BigQuery.
--mc-region
A região do Migration Center 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 Data Studio usando a visualização mccastreadinesscombined_vw.

Uso: mconnect create-views project dataset [flags]

Visualizações criadas

  • migrationcenterinfra_vw: mostra dados agrupados de recursos do Migration Center.
  • 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 Data 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)