MSTECH wiki - Contribuições do usuário [pt-br]

Ambientes

2017-11-23T18:26:44Z

Ruz: /* Demonstração geral */

== Desenvolvimento (Git e TFS) ==
=== BlueMonitor_SSO: ===
https://gitlab.mstech.com.br/bluemonitor/bluemonitorsso.git
(entidade: mstech - Central de Serviços)

BD: dev-sql16\DEV_BlueMonitor_SSO

=== BlueControlWeb ===
$/BlueControlWeb/Main/MSTech.BlueControlWEB-FDE-2008

BD: dev-sql16 -> DEV_BlueControlWeb

$/BlueControlWeb/dev/MSTech.BlueControlWEB-SSO-2008

BD: dev-sql16 -> DEV_BlueControlWeb_SSO

== Testes internos ==
=== TS-IIS03 - bluemonitorSSO (antiga fde) ===

http://coresso-bluemonitor-teste.devedu.ms/

http://bluemonitor-teste.devedu.ms/bluemonitorsso/default.aspx

BD: dev-sql16\pub_FDE_*

=== SMESP ===
CoreSSO: http://192.168.10.22:8100

BlueMonitor: http://192.168.10.22:8101

BD: dev-sql14cli\sme_bkp_*

=== testes (RJ ou Correios): ===
http://192.168.10.22:8001 (CoreSSO)

http://192.168.10.22:8002 (BlueMonitor)

http://192.168.10.22:8003 (Bluemonitor API)[[API]]

BD: ts-bd\RJ_BlueMonitor_SSO

login: admin, senha: 123456

=== Suporte MS ===
http://demonstracao.mstech.com.br
(admin, 123456)

== Demonstração: ==
=== Demonstração geral ===
http://demo.mstech.com.br/BlueMonitor/default.aspx
(adminbm, 123456)

Banco: DEM_BlueMonitor

=== Edital Paraiba ===
http://dpb.mstech.com.br (adminbm, 123456)

== Homologação ==
=== SME ===
http://h-coresso.sme.prefeitura.sp.gov.br/

=== FDE ===
(acesso por VPN)

http://coreblues.educacao.intragov

http://h-acessaescola.fde.sp.gov.br/BlueMonitorSSO

== Produção ==
=== SME ===
http://coresso.sme.prefeitura.sp.gov.br/

=== FDE ===
http://coreblues.educacao.sp.gov.br/

http://www.painelacessa.educacao.sp.gov.br/BlueControlWeb/index.aspx

http://www.painelacessa.educacao.sp.gov.br/BlueMonitorSSO/

BlueMonitorAPI

2017-11-21T14:39:25Z

Ruz: /* Inventory */

== CategoriesTree ==

'''[[BMAPI GET api/v1/categoriesTree/(k1Chave)|GET api/v1/categoriesTree/{k1Chave}]]'''
Retorna uma arvore com todas as categorias e unidades administrativas que compõe toda a estrutura de localizações do domínio.

== Devices ==
'''[[BMAPI POST api/v1/devices|POST api/v1/devices]]'''
Cadastra uma máquina no BlueMonitor

== Devices Signals ==
'''[[BMAPI POST api/v1/devices/(k4Chave)/signals|POST api/v1/devices/{k4Chave}/signals]]'''
Registra a atualização do sinal da máquina, indicando que a mesma está ligada

== Devices TurnOff ==
'''[[BMAPI GET api/v1/devices/(k4Chave)/turnoff|GET api/v1/devices/{k4Chave}/turnoff]]'''
Retorna se a máquina deve desligar

'''[[BMAPI POST api/v1/devices/(k4Chave)/turnoff|POST api/v1/devices/{k4Chave}/turnoff]]'''
Registra que a máquina está desligando

== Devices Updates ==
'''[[BMAPI GET api/v1/devices/(k4Chave)/updates|GET api/v1/devices/{k4Chave}/updates]]'''
Retorna os updates associados à máquina

== Devices Updates Status ==
'''[[BMAPI POST api/v1/devices/(k4Chave)/updates/(updateId)/status|POST api/v1/devices/{k4Chave}/updates/{updateId}/status]]'''
Cadastra um novo status de atualização entre um update e uma máquina

'''[[BMAPI PUT api/v1/devices/(k4Chave)/updates/(updateId)/status/(id)|PUT api/v1/devices/{k4Chave}/updates/{updateId}/status/{id}]]'''
Atualiza um status de atualização entre um update e uma máquina

== CIE Updates ==
'''[[BMAPI GET api/v1/administrativeunit/(cie)/(type?)/(id:int?)|GET api/v1/administrativeunit/{cie}/{type?}/{id:int?}]]'''
Retorna os updates associados à uma CIE, com um tipo de dispositivo específico opcional.

== Devices Types ==
'''[[BMAPI GET api/v1/deviceTypes|GET api/v1/deviceTypes]]'''
Retorna os Tipos de máquinas

== Domains Categories ==
'''[[BMAPI GET api/v1/domains/(k1Chave)/categories|GET api/v1/domains/{k1Chave}/categories]]'''
Retorna as categorias do domínio.

== Domains Categories AdministrativeUnits==
'''[[BMAPI GET api/v1/domains/(k1Chave)/categories/(categoriesId)/administrativeUnit|GET api/v1/domains/{k1Chave}/categories/{categoriesId}/administrativeUnit]]'''
Retorna as Unidades Administrativas que estão associadas à uma categoria do domínio.

== Device Image Protection ==
'''[[BMAPI GET api/v1/ImageProtection/(k4)|GET api/v1/ImageProtection/{k4}]]'''
Retorna dados sobre a proteção do update para uma máquina específica.

'''[[BMAPI POST api/v1/ImageProtection|POST api/v1/ImageProtection]]'''
Cria um novo registro referente a proteção de update de um dispositivo.

'''[[BMAPI PUT api/v1/ImageProtection|PUT api/v1/ImageProtection]]'''
Atualiza um registro referente a proteção de update de um dispositivo.

== Inventory ==

=== Ambientes ===
Configuração: Tabela ''PARAMETRO'' do BlueMonitor
==== Teste (bluemonitor-teste.devedu.ms) ====
http://192.168.44.11:9200
'''Btracker:''' /bluemonitorteste/report
'''Inventário software:''' inventorysoftwareteste
'''Inventário hardware:''' inventoryhardwareteste

==== Desenvolvimento ====
http://192.168.44.11:9200
'''Btracker:''' /bluemonitor/report
'''Inventário software:''' inventorysoftware
'''Inventário hardware:''' inventoryhardware

==== Demo ====
http://demo-kibana.mstech.com.br
http://demo-logstash.mstech.com.br
http://demo-elasticsearch.mstech.com.br
'''Btracker:''' /bluemonitordemo/report
'''Inventário software:''' inventorysoftwaredemo
'''Inventário hardware:''' inventoryhardwaredemo

==== Chamadas API ====
'''[[BMAPI POST api/v1/inventoryhardware/|POST api/v1/inventoryhardware/]]'''
Envia um inventário para o ElasticSearch através do BlueMonitor.

'''[[BMAPI POST api/v1/inventorysoftware/|POST api/v1/inventorysoftware/]]'''
Envia um inventário para o ElasticSearch através do BlueMonitor.

Ambientes

2017-11-20T12:11:01Z

Ruz: /* Demonstração geral */

== Desenvolvimento (Git e TFS) ==
=== BlueMonitor_SSO: ===
https://gitlab.mstech.com.br/bluemonitor/bluemonitorsso.git
(entidade: mstech - Central de Serviços)

BD: dev-sql16\DEV_BlueMonitor_SSO

=== BlueControlWeb ===
$/BlueControlWeb/Main/MSTech.BlueControlWEB-FDE-2008

BD: dev-sql16 -> DEV_BlueControlWeb

$/BlueControlWeb/dev/MSTech.BlueControlWEB-SSO-2008

BD: dev-sql16 -> DEV_BlueControlWeb_SSO

== Testes internos ==
=== TS-IIS03 - bluemonitorSSO (antiga fde) ===

http://coresso-bluemonitor-teste.devedu.ms/

http://bluemonitor-teste.devedu.ms/bluemonitorsso/default.aspx

BD: dev-sql16\pub_FDE_*

=== SMESP ===
CoreSSO: http://192.168.10.22:8100

BlueMonitor: http://192.168.10.22:8101

BD: dev-sql14cli\sme_bkp_*

=== testes (RJ ou Correios): ===
http://192.168.10.22:8001 (CoreSSO)

http://192.168.10.22:8002 (BlueMonitor)

http://192.168.10.22:8003 (Bluemonitor API)[[API]]

BD: ts-bd\RJ_BlueMonitor_SSO

login: admin, senha: 123456

=== Suporte MS ===
http://demonstracao.mstech.com.br
(admin, 123456)

== Demonstração: ==
=== Demonstração geral ===
http://demo.mstech.com.br/BlueMonitor/default.aspx
(adminbm, 123456)

=== Edital Paraiba ===
http://dpb.mstech.com.br (adminbm, 123456)

== Homologação ==
=== SME ===
http://h-coresso.sme.prefeitura.sp.gov.br/

=== FDE ===
(acesso por VPN)

http://coreblues.educacao.intragov

http://h-acessaescola.fde.sp.gov.br/BlueMonitorSSO

== Produção ==
=== SME ===
http://coresso.sme.prefeitura.sp.gov.br/

=== FDE ===
http://coreblues.educacao.sp.gov.br/

http://www.painelacessa.educacao.sp.gov.br/BlueControlWeb/index.aspx

http://www.painelacessa.educacao.sp.gov.br/BlueMonitorSSO/

BMAPI PUT api/v1/ImageProtection

2017-11-16T17:56:46Z

Ruz: /* Exemplo */

[[BlueMonitorAPI]] > [[BlueMonitorAPI#Device Image Protection|Devices Image Protection]]

== ImageStatus (Situações possíveis das imagens) ==

Strings que devem ser enviadas/recebidas como chave da situação (status) atual da imagem.

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| ProtectRequest
| Solicitação de proteção da imagem.
| String
|-
| Protecting
| Após receber a solicitação de proteção, o status da imagem passa a este status intermediário, mostrando que está em processo de proteção, mas ainda não concluída.
| String
|-
| Protected
| Após a conclusão do pedido de solicitação de proteção da imagem, o status da mesma deve ser alterado para este, mostrando que a imagem agora está protegida.
| String
|-
| UnprotectRequest
| Solicitação de abertura da imagem (desproteger).
| String
|-
| Unprotecting
| Processo intermediário, ainda não concluído, de abertura da imagem.
| String
|-
| Unprotected
| Mostra que a imagem está agora, aberta (desprotegida).
| String
|}

== Request ==

=== Header ===
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| Content-Type
| application/json
| String
|-
| Authorization
| Basic Authentication
| Auth
|-
| k1
| K1 Chave (código do domínio, ou da unidade Administrativa)
| String
|}

=== Corpo ===

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| K4
| Chave do dispositivo (máquina)
| String
|-
| ImageStatus
| Situação da imagem naquele dispositivo.
| String
|-
| HasUpdrive
| Retorna se um dispositivo possui updrive instalado, para controle no blueMonitor
| Bool
|}

=== Exemplo ===

http://bluemonitor-teste.devedu.ms/BlueMonitorAPI/api/v1/ImageProtection

{
"K4": "2485382125193"
, "ImageStatus": "UnprotectRequest"
, "HasUpdrive" : "true"
, "Status":2
}

== Response ==

=== Http Status Code ===
{| class="wikitable"
|-
! Código
! Nome
! Descrição
|-
| 201
| Created
| Registro incluído com sucesso.
|-
| 404
| NotFound
| Chave K4 informada não foi encontrada no servidor.
|-
| 409
| Conflict
| Chave K4 informada já possui registro de proteção de imagem criado. Usar o comando de atualização (PUT) ao invés de criação (POST).
|-
| 412
| PreconditionFailed
| Chave K4 deve ser informada no corpo da requisição.
|-
| 500
| InternalServerError
| Erro inesperado
|}

=== Corpo ===

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| K4
| Chave do dispositivo (máquina)
| String
|-
| ImageStatus
| Situação da imagem naquele dispositivo.
| String
|-
| HasUpdrive
| Retorna se um dispositivo possui updrive instalado, para controle no blueMonitor
| Bool
|-
| Status
| Mostra situação do registro (1 = ativo; 2 = inativo; 3 = excluído)
| Byte
|}

=== Exemplo ===

{
"K4": "2485382125193",
"ImageStatus": "UnprotectRequest",
"HasUpdrive": true,
"Status": 2
}

BMAPI PUT api/v1/ImageProtection

2017-11-16T17:56:39Z

Ruz: /* Exemplo */

[[BlueMonitorAPI]] > [[BlueMonitorAPI#Device Image Protection|Devices Image Protection]]

== ImageStatus (Situações possíveis das imagens) ==

Strings que devem ser enviadas/recebidas como chave da situação (status) atual da imagem.

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| ProtectRequest
| Solicitação de proteção da imagem.
| String
|-
| Protecting
| Após receber a solicitação de proteção, o status da imagem passa a este status intermediário, mostrando que está em processo de proteção, mas ainda não concluída.
| String
|-
| Protected
| Após a conclusão do pedido de solicitação de proteção da imagem, o status da mesma deve ser alterado para este, mostrando que a imagem agora está protegida.
| String
|-
| UnprotectRequest
| Solicitação de abertura da imagem (desproteger).
| String
|-
| Unprotecting
| Processo intermediário, ainda não concluído, de abertura da imagem.
| String
|-
| Unprotected
| Mostra que a imagem está agora, aberta (desprotegida).
| String
|}

== Request ==

=== Header ===
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| Content-Type
| application/json
| String
|-
| Authorization
| Basic Authentication
| Auth
|-
| k1
| K1 Chave (código do domínio, ou da unidade Administrativa)
| String
|}

=== Corpo ===

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| K4
| Chave do dispositivo (máquina)
| String
|-
| ImageStatus
| Situação da imagem naquele dispositivo.
| String
|-
| HasUpdrive
| Retorna se um dispositivo possui updrive instalado, para controle no blueMonitor
| Bool
|}

=== Exemplo ===

http://bluemonitor-teste.devedu.ms/BlueMonitorAPI/api/v1/ImageProtection

{
"K4": "2485382125193"
, "ImageStatus": "UnprotectRequest"
, "HasUpdrive" : "true"
, "Status":2
}

== Response ==

=== Http Status Code ===
{| class="wikitable"
|-
! Código
! Nome
! Descrição
|-
| 201
| Created
| Registro incluído com sucesso.
|-
| 404
| NotFound
| Chave K4 informada não foi encontrada no servidor.
|-
| 409
| Conflict
| Chave K4 informada já possui registro de proteção de imagem criado. Usar o comando de atualização (PUT) ao invés de criação (POST).
|-
| 412
| PreconditionFailed
| Chave K4 deve ser informada no corpo da requisição.
|-
| 500
| InternalServerError
| Erro inesperado
|}

=== Corpo ===

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| K4
| Chave do dispositivo (máquina)
| String
|-
| ImageStatus
| Situação da imagem naquele dispositivo.
| String
|-
| HasUpdrive
| Retorna se um dispositivo possui updrive instalado, para controle no blueMonitor
| Bool
|-
| Status
| Mostra situação do registro (1 = ativo; 2 = inativo; 3 = excluído)
| Byte
|}

=== Exemplo ===

{
"K4": "885246744077074624",
"ImageStatus": "UnprotectRequest",
"HasUpdrive": true,
"Status": 2
}

BMAPI GET api/v1/ImageProtection/(k4)

2017-11-16T17:56:28Z

Ruz: /* Exemplo */

[[BlueMonitorAPI]] > [[BlueMonitorAPI#Device Image Protection|Devices Image Protection]]

== ImageStatus (Situações possíveis das imagens) ==

Strings que devem ser enviadas/recebidas como chave da situação (status) atual da imagem.

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| ProtectRequest
| Solicitação de proteção da imagem.
| String
|-
| Protecting
| Após receber a solicitação de proteção, o status da imagem passa a este status intermediário, mostrando que está em processo de proteção, mas ainda não concluída.
| String
|-
| Protected
| Após a conclusão do pedido de solicitação de proteção da imagem, o status da mesma deve ser alterado para este, mostrando que a imagem agora está protegida.
| String
|-
| UnprotectRequest
| Solicitação de abertura da imagem (desproteger).
| String
|-
| Unprotecting
| Processo intermediário, ainda não concluído, de abertura da imagem.
| String
|-
| Unprotected
| Mostra que a imagem está agora, aberta (desprotegida).
| String
|}

== Request ==

=== Parâmetros ===
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| k4
| Código k4 (k4Chave) de um dispositivo
| String
|}

=== Header ===
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| Content-Type
| application/json
| String
|-
| Authorization
| Basic Authentication
| Auth
|-
| k1
| K1 Chave (código do domínio, ou da unidade Administrativa)
| String
|}

=== Corpo ===

Não há informação no corpo

=== Exemplo ===

http://bluemonitor-teste.devedu.ms/BlueMonitorAPI/api/v1/ImageProtection/2485382125193

== Response ==

=== Http Status Code ===
{| class="wikitable"
|-
! Código
! Nome
! Descrição
|-
| 200
| OK
|
|-
| 500
| InternalServerError
| Erro inesperado
|}

=== Corpo ===

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| K4
| Chave do dispositivo (máquina)
| String
|-
| ImageStatus
| Situação da imagem naquele dispositivo.
| String
|-
| HasUpdrive
| Retorna se um dispositivo possui updrive instalado, para controle no blueMonitor
| Bool
|-
| Status
| Mostra situação do registro (1 = ativo; 2 = inativo; 3 = excluído)
| Byte
|}

=== Exemplo ===

{
"K4": "2485382125193",
"ImageStatus": "Protected",
"HasUpdrive": true,
"Status": 2
}

BMAPI POST api/v1/ImageProtection

2017-11-16T17:56:17Z

Ruz: /* Exemplo */

[[BlueMonitorAPI]] > [[BlueMonitorAPI#Device Image Protection|Devices Image Protection]]

== ImageStatus (Situações possíveis das imagens) ==

Strings que devem ser enviadas/recebidas como chave da situação (status) atual da imagem.

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| ProtectRequest
| Solicitação de proteção da imagem.
| String
|-
| Protecting
| Após receber a solicitação de proteção, o status da imagem passa a este status intermediário, mostrando que está em processo de proteção, mas ainda não concluída.
| String
|-
| Protected
| Após a conclusão do pedido de solicitação de proteção da imagem, o status da mesma deve ser alterado para este, mostrando que a imagem agora está protegida.
| String
|-
| UnprotectRequest
| Solicitação de abertura da imagem (desproteger).
| String
|-
| Unprotecting
| Processo intermediário, ainda não concluído, de abertura da imagem.
| String
|-
| Unprotected
| Mostra que a imagem está agora, aberta (desprotegida).
| String
|}

== Request ==

=== Header ===
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| Content-Type
| application/json
| String
|-
| Authorization
| Basic Authentication
| Auth
|-
| k1
| K1 Chave (código do domínio, ou da unidade Administrativa)
| String
|}

=== Corpo ===

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| K4
| Chave do dispositivo (máquina)
| String
|-
| ImageStatus
| Situação da imagem naquele dispositivo.
| String
|-
| HasUpdrive
| Retorna se um dispositivo possui updrive instalado, para controle no blueMonitor
| Bool
|-
| Status
| Mostra situação do registro (1 = ativo; 2 = inativo; 3 = excluído)
| Byte
|}

=== Exemplo ===

http://bluemonitor-teste.devedu.ms/BlueMonitorAPI/api/v1/ImageProtection

{
"K4": "2485382125193"
, "ImageStatus": "Unprotecting"
, "HasUpdrive" : "true"
}

== Response ==

=== Http Status Code ===
{| class="wikitable"
|-
! Código
! Nome
! Descrição
|-
| 200
| OK
| Registro alterado com sucesso.
|-
| 404
| NotFound
| Chave K4 informada não foi encontrada no servidor, OU não foi encontrado um registro para ser atualizado (PUT). Deve ser criado primeiro (POST).
|-
| 412
| PreconditionFailed
| Chave K4 deve ser informada no corpo da requisição.
|-
| 500
| InternalServerError
| Erro inesperado
|}

=== Corpo ===

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| K4
| Chave do dispositivo (máquina)
| String
|-
| ImageStatus
| Situação da imagem naquele dispositivo.
| String
|-
| HasUpdrive
| Retorna se um dispositivo possui updrive instalado, para controle no blueMonitor
| Bool
|-
| Status
| Mostra situação do registro (1 = ativo; 2 = inativo; 3 = excluído)
| Byte
|}

=== Exemplo ===
{
"K4": "2485382125193",
"ImageStatus": "Unprotecting",
"HasUpdrive": true,
"Status": 1
}

BMAPI POST api/v1/ImageProtection

2017-11-16T17:56:09Z

Ruz: /* Exemplo */

[[BlueMonitorAPI]] > [[BlueMonitorAPI#Device Image Protection|Devices Image Protection]]

== ImageStatus (Situações possíveis das imagens) ==

Strings que devem ser enviadas/recebidas como chave da situação (status) atual da imagem.

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| ProtectRequest
| Solicitação de proteção da imagem.
| String
|-
| Protecting
| Após receber a solicitação de proteção, o status da imagem passa a este status intermediário, mostrando que está em processo de proteção, mas ainda não concluída.
| String
|-
| Protected
| Após a conclusão do pedido de solicitação de proteção da imagem, o status da mesma deve ser alterado para este, mostrando que a imagem agora está protegida.
| String
|-
| UnprotectRequest
| Solicitação de abertura da imagem (desproteger).
| String
|-
| Unprotecting
| Processo intermediário, ainda não concluído, de abertura da imagem.
| String
|-
| Unprotected
| Mostra que a imagem está agora, aberta (desprotegida).
| String
|}

== Request ==

=== Header ===
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| Content-Type
| application/json
| String
|-
| Authorization
| Basic Authentication
| Auth
|-
| k1
| K1 Chave (código do domínio, ou da unidade Administrativa)
| String
|}

=== Corpo ===

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| K4
| Chave do dispositivo (máquina)
| String
|-
| ImageStatus
| Situação da imagem naquele dispositivo.
| String
|-
| HasUpdrive
| Retorna se um dispositivo possui updrive instalado, para controle no blueMonitor
| Bool
|-
| Status
| Mostra situação do registro (1 = ativo; 2 = inativo; 3 = excluído)
| Byte
|}

=== Exemplo ===

http://bluemonitor-teste.devedu.ms/BlueMonitorAPI/api/v1/ImageProtection

{
"K4": "2485382125193"
, "ImageStatus": "Unprotecting"
, "HasUpdrive" : "true"
}

== Response ==

=== Http Status Code ===
{| class="wikitable"
|-
! Código
! Nome
! Descrição
|-
| 200
| OK
| Registro alterado com sucesso.
|-
| 404
| NotFound
| Chave K4 informada não foi encontrada no servidor, OU não foi encontrado um registro para ser atualizado (PUT). Deve ser criado primeiro (POST).
|-
| 412
| PreconditionFailed
| Chave K4 deve ser informada no corpo da requisição.
|-
| 500
| InternalServerError
| Erro inesperado
|}

=== Corpo ===

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| K4
| Chave do dispositivo (máquina)
| String
|-
| ImageStatus
| Situação da imagem naquele dispositivo.
| String
|-
| HasUpdrive
| Retorna se um dispositivo possui updrive instalado, para controle no blueMonitor
| Bool
|-
| Status
| Mostra situação do registro (1 = ativo; 2 = inativo; 3 = excluído)
| Byte
|}

=== Exemplo ===
{
"K4": "507006210708",
"ImageStatus": "Unprotecting",
"HasUpdrive": true,
"Status": 1
}

BMAPI GET api/v1/ImageProtection/(k4)

2017-11-16T17:55:53Z

Ruz: /* Exemplo */

[[BlueMonitorAPI]] > [[BlueMonitorAPI#Device Image Protection|Devices Image Protection]]

== ImageStatus (Situações possíveis das imagens) ==

Strings que devem ser enviadas/recebidas como chave da situação (status) atual da imagem.

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| ProtectRequest
| Solicitação de proteção da imagem.
| String
|-
| Protecting
| Após receber a solicitação de proteção, o status da imagem passa a este status intermediário, mostrando que está em processo de proteção, mas ainda não concluída.
| String
|-
| Protected
| Após a conclusão do pedido de solicitação de proteção da imagem, o status da mesma deve ser alterado para este, mostrando que a imagem agora está protegida.
| String
|-
| UnprotectRequest
| Solicitação de abertura da imagem (desproteger).
| String
|-
| Unprotecting
| Processo intermediário, ainda não concluído, de abertura da imagem.
| String
|-
| Unprotected
| Mostra que a imagem está agora, aberta (desprotegida).
| String
|}

== Request ==

=== Parâmetros ===
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| k4
| Código k4 (k4Chave) de um dispositivo
| String
|}

=== Header ===
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| Content-Type
| application/json
| String
|-
| Authorization
| Basic Authentication
| Auth
|-
| k1
| K1 Chave (código do domínio, ou da unidade Administrativa)
| String
|}

=== Corpo ===

Não há informação no corpo

=== Exemplo ===

http://bluemonitor-teste.devedu.ms/BlueMonitorAPI/api/v1/ImageProtection/2485382125193

== Response ==

=== Http Status Code ===
{| class="wikitable"
|-
! Código
! Nome
! Descrição
|-
| 200
| OK
|
|-
| 500
| InternalServerError
| Erro inesperado
|}

=== Corpo ===

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| K4
| Chave do dispositivo (máquina)
| String
|-
| ImageStatus
| Situação da imagem naquele dispositivo.
| String
|-
| HasUpdrive
| Retorna se um dispositivo possui updrive instalado, para controle no blueMonitor
| Bool
|-
| Status
| Mostra situação do registro (1 = ativo; 2 = inativo; 3 = excluído)
| Byte
|}

=== Exemplo ===

{
"K4": "885246744077074624",
"ImageStatus": "Protected",
"HasUpdrive": true,
"Status": 2
}

BMAPI GET api/v1/ImageProtection/(k4Chave)

2017-11-16T12:35:20Z

Ruz: Página substituída por 'pagina excluída'

pagina excluída

BMAPI GET api/v1/ImageProtection/(k4)

2017-11-16T12:32:43Z

Ruz: /* Exemplo */

[[BlueMonitorAPI]] > [[BlueMonitorAPI#Device Image Protection|Devices Image Protection]]

== ImageStatus (Situações possíveis das imagens) ==

Strings que devem ser enviadas/recebidas como chave da situação (status) atual da imagem.

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| ProtectRequest
| Solicitação de proteção da imagem.
| String
|-
| Protecting
| Após receber a solicitação de proteção, o status da imagem passa a este status intermediário, mostrando que está em processo de proteção, mas ainda não concluída.
| String
|-
| Protected
| Após a conclusão do pedido de solicitação de proteção da imagem, o status da mesma deve ser alterado para este, mostrando que a imagem agora está protegida.
| String
|-
| UnprotectRequest
| Solicitação de abertura da imagem (desproteger).
| String
|-
| Unprotecting
| Processo intermediário, ainda não concluído, de abertura da imagem.
| String
|-
| Unprotected
| Mostra que a imagem está agora, aberta (desprotegida).
| String
|}

== Request ==

=== Parâmetros ===
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| k4
| Código k4 (k4Chave) de um dispositivo
| String
|}

=== Header ===
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| Content-Type
| application/json
| String
|-
| Authorization
| Basic Authentication
| Auth
|-
| k1
| K1 Chave (código do domínio, ou da unidade Administrativa)
| String
|}

=== Corpo ===

Não há informação no corpo

=== Exemplo ===

http://bluemonitor-teste.devedu.ms/BlueMonitorAPI/api/v1/ImageProtection/885246744077074624

== Response ==

=== Http Status Code ===
{| class="wikitable"
|-
! Código
! Nome
! Descrição
|-
| 200
| OK
|
|-
| 500
| InternalServerError
| Erro inesperado
|}

=== Corpo ===

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| K4
| Chave do dispositivo (máquina)
| String
|-
| ImageStatus
| Situação da imagem naquele dispositivo.
| String
|-
| HasUpdrive
| Retorna se um dispositivo possui updrive instalado, para controle no blueMonitor
| Bool
|-
| Status
| Mostra situação do registro (1 = ativo; 2 = inativo; 3 = excluído)
| Byte
|}

=== Exemplo ===

{
"K4": "885246744077074624",
"ImageStatus": "Protected",
"HasUpdrive": true,
"Status": 2
}

BMAPI GET api/v1/ImageProtection/(k4)

2017-11-16T12:29:05Z

Ruz: Criou página com 'BlueMonitorAPI > Devices Image Protection == ImageStatus (Situações possíveis das imagens) == Strings que devem ser enviad...'

[[BlueMonitorAPI]] > [[BlueMonitorAPI#Device Image Protection|Devices Image Protection]]

== ImageStatus (Situações possíveis das imagens) ==

Strings que devem ser enviadas/recebidas como chave da situação (status) atual da imagem.

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| ProtectRequest
| Solicitação de proteção da imagem.
| String
|-
| Protecting
| Após receber a solicitação de proteção, o status da imagem passa a este status intermediário, mostrando que está em processo de proteção, mas ainda não concluída.
| String
|-
| Protected
| Após a conclusão do pedido de solicitação de proteção da imagem, o status da mesma deve ser alterado para este, mostrando que a imagem agora está protegida.
| String
|-
| UnprotectRequest
| Solicitação de abertura da imagem (desproteger).
| String
|-
| Unprotecting
| Processo intermediário, ainda não concluído, de abertura da imagem.
| String
|-
| Unprotected
| Mostra que a imagem está agora, aberta (desprotegida).
| String
|}

== Request ==

=== Parâmetros ===
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| k4
| Código k4 (k4Chave) de um dispositivo
| String
|}

=== Header ===
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| Content-Type
| application/json
| String
|-
| Authorization
| Basic Authentication
| Auth
|-
| k1
| K1 Chave (código do domínio, ou da unidade Administrativa)
| String
|}

=== Corpo ===

Não há informação no corpo

=== Exemplo ===

http://bluemonitor-teste.devedu.ms/BlueMonitorAPI/api/v1/ImageProtection/885246744077074624

== Response ==

=== Http Status Code ===
{| class="wikitable"
|-
! Código
! Nome
! Descrição
|-
| 200
| OK
|
|-
| 500
| InternalServerError
| Erro inesperado
|}

=== Corpo ===

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| K4
| Chave do dispositivo (máquina)
| String
|-
| ImageStatus
| Situação da imagem naquele dispositivo.
| String
|-
| HasUpdrive
| Retorna se um dispositivo possui updrive instalado, para controle no blueMonitor
| Bool
|-
| Status
| Mostra situação do registro (1 = ativo; 2 = inativo; 3 = excluído)
| Byte
|}

=== Exemplo ===

{
"K4": "885246744077074624",
"ImageStatus": "Protected",
"HasUpdrive": true,
"Status": 2
}

BlueMonitorAPI

2017-11-16T12:28:55Z

Ruz: /* Device Image Protection */

== CategoriesTree ==

'''[[BMAPI GET api/v1/categoriesTree/(k1Chave)|GET api/v1/categoriesTree/{k1Chave}]]'''
Retorna uma arvore com todas as categorias e unidades administrativas que compõe toda a estrutura de localizações do domínio.

== Devices ==
'''[[BMAPI POST api/v1/devices|POST api/v1/devices]]'''
Cadastra uma máquina no BlueMonitor

== Devices Signals ==
'''[[BMAPI POST api/v1/devices/(k4Chave)/signals|POST api/v1/devices/{k4Chave}/signals]]'''
Registra a atualização do sinal da máquina, indicando que a mesma está ligada

== Devices TurnOff ==
'''[[BMAPI GET api/v1/devices/(k4Chave)/turnoff|GET api/v1/devices/{k4Chave}/turnoff]]'''
Retorna se a máquina deve desligar

'''[[BMAPI POST api/v1/devices/(k4Chave)/turnoff|POST api/v1/devices/{k4Chave}/turnoff]]'''
Registra que a máquina está desligando

== Devices Updates ==
'''[[BMAPI GET api/v1/devices/(k4Chave)/updates|GET api/v1/devices/{k4Chave}/updates]]'''
Retorna os updates associados à máquina

== Devices Updates Status ==
'''[[BMAPI POST api/v1/devices/(k4Chave)/updates/(updateId)/status|POST api/v1/devices/{k4Chave}/updates/{updateId}/status]]'''
Cadastra um novo status de atualização entre um update e uma máquina

'''[[BMAPI PUT api/v1/devices/(k4Chave)/updates/(updateId)/status/(id)|PUT api/v1/devices/{k4Chave}/updates/{updateId}/status/{id}]]'''
Atualiza um status de atualização entre um update e uma máquina

== CIE Updates ==
'''[[BMAPI GET api/v1/administrativeunit/(cie)/(type?)/(id:int?)|GET api/v1/administrativeunit/{cie}/{type?}/{id:int?}]]'''
Retorna os updates associados à uma CIE, com um tipo de dispositivo específico opcional.

== Devices Types ==
'''[[BMAPI GET api/v1/deviceTypes|GET api/v1/deviceTypes]]'''
Retorna os Tipos de máquinas

== Domains Categories ==
'''[[BMAPI GET api/v1/domains/(k1Chave)/categories|GET api/v1/domains/{k1Chave}/categories]]'''
Retorna as categorias do domínio.

== Domains Categories AdministrativeUnits==
'''[[BMAPI GET api/v1/domains/(k1Chave)/categories/(categoriesId)/administrativeUnit|GET api/v1/domains/{k1Chave}/categories/{categoriesId}/administrativeUnit]]'''
Retorna as Unidades Administrativas que estão associadas à uma categoria do domínio.

== Device Image Protection ==
'''[[BMAPI GET api/v1/ImageProtection/(k4)|GET api/v1/ImageProtection/{k4}]]'''
Retorna dados sobre a proteção do update para uma máquina específica.

'''[[BMAPI POST api/v1/ImageProtection|POST api/v1/ImageProtection]]'''
Cria um novo registro referente a proteção de update de um dispositivo.

'''[[BMAPI PUT api/v1/ImageProtection|PUT api/v1/ImageProtection]]'''
Atualiza um registro referente a proteção de update de um dispositivo.

== Inventory ==

=== Ambientes ===
Configuração: Tabela ''PARAMETRO'' do BlueMonitor
==== Teste (painelAcessa) ====
http://192.168.46.3:9200
'''Btracker:''' /bluemonitorteste/report
'''Inventário software:''' inventorysoftwareteste
'''Inventário hardware:''' inventoryhardwareteste

==== Desenvolvimento ====
http://192.168.46.3:9200
'''Btracker:''' /bluemonitor/report
'''Inventário software:''' inventorysoftware
'''Inventário hardware:''' inventoryhardware

==== Demo ====
http://demo-kibana.mstech.com.br
http://demo-logstash.mstech.com.br
http://demo-elasticsearch.mstech.com.br
'''Btracker:''' /bluemonitordemo/report
'''Inventário software:''' inventorysoftwaredemo
'''Inventário hardware:''' inventoryhardwaredemo

==== Chamadas API ====
'''[[BMAPI POST api/v1/inventoryhardware/|POST api/v1/inventoryhardware/]]'''
Envia um inventário para o ElasticSearch através do BlueMonitor.

'''[[BMAPI POST api/v1/inventorysoftware/|POST api/v1/inventorysoftware/]]'''
Envia um inventário para o ElasticSearch através do BlueMonitor.

BMAPI POST api/v1/ImageProtection

2017-11-16T12:27:51Z

Ruz: /* Response */

[[BlueMonitorAPI]] > [[BlueMonitorAPI#Device Image Protection|Devices Image Protection]]

== ImageStatus (Situações possíveis das imagens) ==

Strings que devem ser enviadas/recebidas como chave da situação (status) atual da imagem.

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| ProtectRequest
| Solicitação de proteção da imagem.
| String
|-
| Protecting
| Após receber a solicitação de proteção, o status da imagem passa a este status intermediário, mostrando que está em processo de proteção, mas ainda não concluída.
| String
|-
| Protected
| Após a conclusão do pedido de solicitação de proteção da imagem, o status da mesma deve ser alterado para este, mostrando que a imagem agora está protegida.
| String
|-
| UnprotectRequest
| Solicitação de abertura da imagem (desproteger).
| String
|-
| Unprotecting
| Processo intermediário, ainda não concluído, de abertura da imagem.
| String
|-
| Unprotected
| Mostra que a imagem está agora, aberta (desprotegida).
| String
|}

== Request ==

=== Header ===
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| Content-Type
| application/json
| String
|-
| Authorization
| Basic Authentication
| Auth
|-
| k1
| K1 Chave (código do domínio, ou da unidade Administrativa)
| String
|}

=== Corpo ===

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| K4
| Chave do dispositivo (máquina)
| String
|-
| ImageStatus
| Situação da imagem naquele dispositivo.
| String
|-
| HasUpdrive
| Retorna se um dispositivo possui updrive instalado, para controle no blueMonitor
| Bool
|-
| Status
| Mostra situação do registro (1 = ativo; 2 = inativo; 3 = excluído)
| Byte
|}

=== Exemplo ===

http://bluemonitor-teste.devedu.ms/BlueMonitorAPI/api/v1/ImageProtection

{
"K4": "507006210708"
, "ImageStatus": "Unprotecting"
, "HasUpdrive" : "true"
}

== Response ==

=== Http Status Code ===
{| class="wikitable"
|-
! Código
! Nome
! Descrição
|-
| 200
| OK
| Registro alterado com sucesso.
|-
| 404
| NotFound
| Chave K4 informada não foi encontrada no servidor, OU não foi encontrado um registro para ser atualizado (PUT). Deve ser criado primeiro (POST).
|-
| 412
| PreconditionFailed
| Chave K4 deve ser informada no corpo da requisição.
|-
| 500
| InternalServerError
| Erro inesperado
|}

=== Corpo ===

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| K4
| Chave do dispositivo (máquina)
| String
|-
| ImageStatus
| Situação da imagem naquele dispositivo.
| String
|-
| HasUpdrive
| Retorna se um dispositivo possui updrive instalado, para controle no blueMonitor
| Bool
|-
| Status
| Mostra situação do registro (1 = ativo; 2 = inativo; 3 = excluído)
| Byte
|}

=== Exemplo ===
{
"K4": "507006210708",
"ImageStatus": "Unprotecting",
"HasUpdrive": true,
"Status": 1
}

BMAPI POST api/v1/ImageProtection

2017-11-16T12:20:24Z

Ruz:

[[BlueMonitorAPI]] > [[BlueMonitorAPI#Device Image Protection|Devices Image Protection]]

== ImageStatus (Situações possíveis das imagens) ==

Strings que devem ser enviadas/recebidas como chave da situação (status) atual da imagem.

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| ProtectRequest
| Solicitação de proteção da imagem.
| String
|-
| Protecting
| Após receber a solicitação de proteção, o status da imagem passa a este status intermediário, mostrando que está em processo de proteção, mas ainda não concluída.
| String
|-
| Protected
| Após a conclusão do pedido de solicitação de proteção da imagem, o status da mesma deve ser alterado para este, mostrando que a imagem agora está protegida.
| String
|-
| UnprotectRequest
| Solicitação de abertura da imagem (desproteger).
| String
|-
| Unprotecting
| Processo intermediário, ainda não concluído, de abertura da imagem.
| String
|-
| Unprotected
| Mostra que a imagem está agora, aberta (desprotegida).
| String
|}

== Request ==

=== Header ===
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| Content-Type
| application/json
| String
|-
| Authorization
| Basic Authentication
| Auth
|-
| k1
| K1 Chave (código do domínio, ou da unidade Administrativa)
| String
|}

=== Corpo ===

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| K4
| Chave do dispositivo (máquina)
| String
|-
| ImageStatus
| Situação da imagem naquele dispositivo.
| String
|-
| HasUpdrive
| Retorna se um dispositivo possui updrive instalado, para controle no blueMonitor
| Bool
|-
| Status
| Mostra situação do registro (1 = ativo; 2 = inativo; 3 = excluído)
| Byte
|}

=== Exemplo ===

http://bluemonitor-teste.devedu.ms/BlueMonitorAPI/api/v1/ImageProtection

{
"K4": "507006210708"
, "ImageStatus": "Unprotecting"
, "HasUpdrive" : "true"
}

== Response ==

=== Http Status Code ===
{| class="wikitable"
|-
! Código
! Nome
! Descrição
|-
| 200
| OK
| Registro alterado com sucesso.
|-
| 404
| NotFound
| Chave K4 informada não foi encontrada no servidor, OU não foi encontrado um registro para ser atualizado (PUT). Deve ser criado primeiro (POST).
|-
| 412
| PreconditionFailed
| Chave K4 deve ser informada no corpo da requisição.
|-
| 500
| InternalServerError
| Erro inesperado
|}

=== Corpo ===

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| K4
| Chave do dispositivo (máquina)
| String
|-
| ImageStatus
| Situação da imagem naquele dispositivo.
| String
|-
| HasUpdrive
| Retorna se um dispositivo possui updrive instalado, para controle no blueMonitor
| Bool
|-
| Status
| Mostra situação do registro (1 = ativo; 2 = inativo; 3 = excluído)
| Byte
|}

BMAPI PUT api/v1/ImageProtection

2017-11-16T12:07:04Z

Ruz: /* Exemplo */

[[BlueMonitorAPI]] > [[BlueMonitorAPI#Device Image Protection|Devices Image Protection]]

== ImageStatus (Situações possíveis das imagens) ==

Strings que devem ser enviadas/recebidas como chave da situação (status) atual da imagem.

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| ProtectRequest
| Solicitação de proteção da imagem.
| String
|-
| Protecting
| Após receber a solicitação de proteção, o status da imagem passa a este status intermediário, mostrando que está em processo de proteção, mas ainda não concluída.
| String
|-
| Protected
| Após a conclusão do pedido de solicitação de proteção da imagem, o status da mesma deve ser alterado para este, mostrando que a imagem agora está protegida.
| String
|-
| UnprotectRequest
| Solicitação de abertura da imagem (desproteger).
| String
|-
| Unprotecting
| Processo intermediário, ainda não concluído, de abertura da imagem.
| String
|-
| Unprotected
| Mostra que a imagem está agora, aberta (desprotegida).
| String
|}

== Request ==

=== Header ===
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| Content-Type
| application/json
| String
|-
| Authorization
| Basic Authentication
| Auth
|-
| k1
| K1 Chave (código do domínio, ou da unidade Administrativa)
| String
|}

=== Corpo ===

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| K4
| Chave do dispositivo (máquina)
| String
|-
| ImageStatus
| Situação da imagem naquele dispositivo.
| String
|-
| HasUpdrive
| Retorna se um dispositivo possui updrive instalado, para controle no blueMonitor
| Bool
|}

=== Exemplo ===

http://bluemonitor-teste.devedu.ms/BlueMonitorAPI/api/v1/ImageProtection

{
"K4": "885246744077074624"
, "ImageStatus": "UnprotectRequest"
, "HasUpdrive" : "true"
, "Status":2
}

== Response ==

=== Http Status Code ===
{| class="wikitable"
|-
! Código
! Nome
! Descrição
|-
| 201
| Created
| Registro incluído com sucesso.
|-
| 404
| NotFound
| Chave K4 informada não foi encontrada no servidor.
|-
| 409
| Conflict
| Chave K4 informada já possui registro de proteção de imagem criado. Usar o comando de atualização (PUT) ao invés de criação (POST).
|-
| 412
| PreconditionFailed
| Chave K4 deve ser informada no corpo da requisição.
|-
| 500
| InternalServerError
| Erro inesperado
|}

=== Corpo ===

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| K4
| Chave do dispositivo (máquina)
| String
|-
| ImageStatus
| Situação da imagem naquele dispositivo.
| String
|-
| HasUpdrive
| Retorna se um dispositivo possui updrive instalado, para controle no blueMonitor
| Bool
|-
| Status
| Mostra situação do registro (1 = ativo; 2 = inativo; 3 = excluído)
| Byte
|}

=== Exemplo ===

{
"K4": "885246744077074624",
"ImageStatus": "UnprotectRequest",
"HasUpdrive": true,
"Status": 2
}

BMAPI PUT api/v1/ImageProtection

2017-11-16T12:05:06Z

Ruz: Criou página com 'BlueMonitorAPI > Devices Image Protection == ImageStatus (Situações possíveis das imagens) == Strings que devem ser enviad...'

[[BlueMonitorAPI]] > [[BlueMonitorAPI#Device Image Protection|Devices Image Protection]]

== ImageStatus (Situações possíveis das imagens) ==

Strings que devem ser enviadas/recebidas como chave da situação (status) atual da imagem.

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| ProtectRequest
| Solicitação de proteção da imagem.
| String
|-
| Protecting
| Após receber a solicitação de proteção, o status da imagem passa a este status intermediário, mostrando que está em processo de proteção, mas ainda não concluída.
| String
|-
| Protected
| Após a conclusão do pedido de solicitação de proteção da imagem, o status da mesma deve ser alterado para este, mostrando que a imagem agora está protegida.
| String
|-
| UnprotectRequest
| Solicitação de abertura da imagem (desproteger).
| String
|-
| Unprotecting
| Processo intermediário, ainda não concluído, de abertura da imagem.
| String
|-
| Unprotected
| Mostra que a imagem está agora, aberta (desprotegida).
| String
|}

== Request ==

=== Header ===
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| Content-Type
| application/json
| String
|-
| Authorization
| Basic Authentication
| Auth
|-
| k1
| K1 Chave (código do domínio, ou da unidade Administrativa)
| String
|}

=== Corpo ===

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| K4
| Chave do dispositivo (máquina)
| String
|-
| ImageStatus
| Situação da imagem naquele dispositivo.
| String
|-
| HasUpdrive
| Retorna se um dispositivo possui updrive instalado, para controle no blueMonitor
| Bool
|}

=== Exemplo ===

{
"K4": "885246744077074624"
, "ImageStatus": "UnprotectRequest"
, "HasUpdrive" : "true"
, "Status":2
}

== Response ==

=== Http Status Code ===
{| class="wikitable"
|-
! Código
! Nome
! Descrição
|-
| 201
| Created
| Registro incluído com sucesso.
|-
| 404
| NotFound
| Chave K4 informada não foi encontrada no servidor.
|-
| 409
| Conflict
| Chave K4 informada já possui registro de proteção de imagem criado. Usar o comando de atualização (PUT) ao invés de criação (POST).
|-
| 412
| PreconditionFailed
| Chave K4 deve ser informada no corpo da requisição.
|-
| 500
| InternalServerError
| Erro inesperado
|}

=== Corpo ===

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| K4
| Chave do dispositivo (máquina)
| String
|-
| ImageStatus
| Situação da imagem naquele dispositivo.
| String
|-
| HasUpdrive
| Retorna se um dispositivo possui updrive instalado, para controle no blueMonitor
| Bool
|-
| Status
| Mostra situação do registro (1 = ativo; 2 = inativo; 3 = excluído)
| Byte
|}

=== Exemplo ===

{
"K4": "885246744077074624",
"ImageStatus": "UnprotectRequest",
"HasUpdrive": true,
"Status": 2
}

BMAPI POST api/v1/ImageProtection

2017-11-16T11:55:55Z

Ruz:

[[BlueMonitorAPI]] > [[BlueMonitorAPI#Device Image Protection|Devices Image Protection]]

== ImageStatus (Situações possíveis das imagens) ==

Strings que devem ser enviadas/recebidas como chave da situação (status) atual da imagem.

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| ProtectRequest
| Solicitação de proteção da imagem.
| String
|-
| Protecting
| Após receber a solicitação de proteção, o status da imagem passa a este status intermediário, mostrando que está em processo de proteção, mas ainda não concluída.
| String
|-
| Protected
| Após a conclusão do pedido de solicitação de proteção da imagem, o status da mesma deve ser alterado para este, mostrando que a imagem agora está protegida.
| String
|-
| UnprotectRequest
| Solicitação de abertura da imagem (desproteger).
| String
|-
| Unprotecting
| Processo intermediário, ainda não concluído, de abertura da imagem.
| String
|-
| Unprotected
| Mostra que a imagem está agora, aberta (desprotegida).
| String
|}

== Request ==

=== Header ===
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| Content-Type
| application/json
| String
|-
| Authorization
| Basic Authentication
| Auth
|-
| k1
| K1 Chave (código do domínio, ou da unidade Administrativa)
| String
|}

=== Corpo ===

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| K4
| Chave do dispositivo (máquina)
| String
|-
| ImageStatus
| Situação da imagem naquele dispositivo.
| String
|-
| HasUpdrive
| Retorna se um dispositivo possui updrive instalado, para controle no blueMonitor
| Bool
|-
| Status
| Mostra situação do registro (1 = ativo; 2 = inativo; 3 = excluído)
| Byte
|}

== Response ==

=== Http Status Code ===
{| class="wikitable"
|-
! Código
! Nome
! Descrição
|-
| 200
| OK
| Registro alterado com sucesso.
|-
| 404
| NotFound
| Chave K4 informada não foi encontrada no servidor, OU não foi encontrado um registro para ser atualizado (PUT). Deve ser criado primeiro (POST).
|-
| 412
| PreconditionFailed
| Chave K4 deve ser informada no corpo da requisição.
|-
| 500
| InternalServerError
| Erro inesperado
|}

=== Corpo ===

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| K4
| Chave do dispositivo (máquina)
| String
|-
| ImageStatus
| Situação da imagem naquele dispositivo.
| String
|-
| HasUpdrive
| Retorna se um dispositivo possui updrive instalado, para controle no blueMonitor
| Bool
|-
| Status
| Mostra situação do registro (1 = ativo; 2 = inativo; 3 = excluído)
| Byte
|}

BMAPI POST api/v1/ImageProtection

2017-11-16T11:49:43Z

Ruz: /* ImageStatus (Situações possíveis) */

[[BlueMonitorAPI]] > [[BlueMonitorAPI#Device Image Protection|Devices Image Protection]]

== ImageStatus (Situações possíveis das imagens) ==

Strings que devem ser enviadas/recebidas como chave da situação (status) atual da imagem.

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| ProtectRequest
| Solicitação de proteção da imagem.
| String
|-
| Protecting
| Após receber a solicitação de proteção, o status da imagem passa a este status intermediário, mostrando que está em processo de proteção, mas ainda não concluída.
| String
|-
| Protected
| Após a conclusão do pedido de solicitação de proteção da imagem, o status da mesma deve ser alterado para este, mostrando que a imagem agora está protegida.
| String
|-
| UnprotectRequest
| Solicitação de abertura da imagem (desproteger).
| String
|-
| Unprotecting
| Processo intermediário, ainda não concluído, de abertura da imagem.
| String
|-
| Unprotected
| Mostra que a imagem está agora, aberta (desprotegida).
| String
|}

== Request ==

=== Header ===
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| Content-Type
| application/json
| String
|-
| Authorization
| Basic Authentication
| Auth
|-
| k1
| K1 Chave (código do domínio, ou da unidade Administrativa)
| String
|}

=== Corpo ===

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| K4
| Chave do dispositivo (máquina)
| String
|-
| ImageStatus
| Situação da imagem naquele dispositivo.
| String
|-
| HasUpdrive
| Retorna se um dispositivo possui updrive instalado, para controle no blueMonitor
| Bool
|}

== Response ==

=== Http Status Code ===
{| class="wikitable"
|-
! Código
! Nome
! Descrição
|-
| 201
| Created
| Registro incluído com sucesso.
|-
| 404
| NotFound
| Chave K4 informada não foi encontrada no servidor.
|-
| 409
| Conflict
| Chave K4 informada já possui registro de proteção de imagem criado. Usar o comando de atualização (PUT) ao invés de criação (POST).
|-
| 412
| PreconditionFailed
| Chave K4 deve ser informada no corpo da requisição.
|-
| 500
| InternalServerError
| Erro inesperado
|}

=== Corpo ===

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| K4
| Chave do dispositivo (máquina)
| String
|-
| ImageStatus
| Situação da imagem naquele dispositivo.
| String
|-
| HasUpdrive
| Retorna se um dispositivo possui updrive instalado, para controle no blueMonitor
| Bool
|-
| Status
| Mostra situação do registro (1 = ativo; 2 = inativo; 3 = excluído)
| Byte
|}

BMAPI POST api/v1/ImageProtection

2017-11-16T11:48:53Z

Ruz: Criou página com 'BlueMonitorAPI > Devices Image Protection == ImageStatus (Situações possíveis) == https://wiki.mstech.com.br/index.php/BMA...'

[[BlueMonitorAPI]] > [[BlueMonitorAPI#Device Image Protection|Devices Image Protection]]

== ImageStatus (Situações possíveis) ==

https://wiki.mstech.com.br/index.php/BMAPI_GET_api/v1/ImageProtection/(k4Chave)#ImageStatus_.28Situa.C3.A7.C3.B5es_poss.C3.ADveis_das_imagens.29

== Request ==

=== Header ===
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| Content-Type
| application/json
| String
|-
| Authorization
| Basic Authentication
| Auth
|-
| k1
| K1 Chave (código do domínio, ou da unidade Administrativa)
| String
|}

=== Corpo ===

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| K4
| Chave do dispositivo (máquina)
| String
|-
| ImageStatus
| Situação da imagem naquele dispositivo.
| String
|-
| HasUpdrive
| Retorna se um dispositivo possui updrive instalado, para controle no blueMonitor
| Bool
|}

== Response ==

=== Http Status Code ===
{| class="wikitable"
|-
! Código
! Nome
! Descrição
|-
| 201
| Created
| Registro incluído com sucesso.
|-
| 404
| NotFound
| Chave K4 informada não foi encontrada no servidor.
|-
| 409
| Conflict
| Chave K4 informada já possui registro de proteção de imagem criado. Usar o comando de atualização (PUT) ao invés de criação (POST).
|-
| 412
| PreconditionFailed
| Chave K4 deve ser informada no corpo da requisição.
|-
| 500
| InternalServerError
| Erro inesperado
|}

=== Corpo ===

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| K4
| Chave do dispositivo (máquina)
| String
|-
| ImageStatus
| Situação da imagem naquele dispositivo.
| String
|-
| HasUpdrive
| Retorna se um dispositivo possui updrive instalado, para controle no blueMonitor
| Bool
|-
| Status
| Mostra situação do registro (1 = ativo; 2 = inativo; 3 = excluído)
| Byte
|}

BMAPI GET api/v1/ImageProtection/(k4Chave)

2017-11-16T11:25:36Z

Ruz:

[[BlueMonitorAPI]] > [[BlueMonitorAPI#Device Image Protection|Devices Image Protection]]

== ImageStatus (Situações possíveis das imagens) ==

Strings que devem ser enviadas/recebidas como chave da situação (status) atual da imagem.

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| ProtectRequest
| Solicitação de proteção da imagem.
| String
|-
| Protecting
| Após receber a solicitação de proteção, o status da imagem passa a este status intermediário, mostrando que está em processo de proteção, mas ainda não concluída.
| String
|-
| Protected
| Após a conclusão do pedido de solicitação de proteção da imagem, o status da mesma deve ser alterado para este, mostrando que a imagem agora está protegida.
| String
|-
| UnprotectRequest
| Solicitação de abertura da imagem (desproteger).
| String
|-
| Unprotecting
| Processo intermediário, ainda não concluído, de abertura da imagem.
| String
|-
| Unprotected
| Mostra que a imagem está agora, aberta (desprotegida).
| String
|}

== Request ==

=== Parâmetros ===
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| k4
| Código k4 (k4Chave) de um dispositivo
| String
|}

=== Header ===
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| Content-Type
| application/json
| String
|-
| Authorization
| Basic Authentication
| Auth
|-
| k1
| K1 Chave (código do domínio, ou da unidade Administrativa)
| String
|}

=== Corpo ===

Não há informação no corpo

=== Exemplo ===

http://bluemonitor-teste.devedu.ms/BlueMonitorAPI/api/v1/ImageProtection/885246744077074624

== Response ==

=== Http Status Code ===
{| class="wikitable"
|-
! Código
! Nome
! Descrição
|-
| 200
| OK
|
|-
| 500
| InternalServerError
| Erro inesperado
|}

=== Corpo ===

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| K4
| Chave do dispositivo (máquina)
| String
|-
| ImageStatus
| Situação da imagem naquele dispositivo.
| String
|-
| HasUpdrive
| Retorna se um dispositivo possui updrive instalado, para controle no blueMonitor
| Bool
|-
| Status
| Mostra situação do registro (1 = ativo; 2 = inativo; 3 = excluído)
| Byte
|}

=== Exemplo ===

{
"K4": "885246744077074624",
"ImageStatus": "Protected",
"HasUpdrive": true,
"Status": 2
}

BMAPI GET api/v1/ImageProtection/(k4Chave)

2017-11-16T11:07:34Z

Ruz:

[[BlueMonitorAPI]] > [[BlueMonitorAPI#Device Image Protection|Devices Image Protection]]

== StatusImagem (Situações possíveis) ==

Strings que devem ser enviadas/recebidas como chave da situação (status) atual da imagem.

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| ProtectRequest
| Solicitação de proteção da imagem.
| String
|-
| Protecting
| Após receber a solicitação de proteção, o status da imagem passa a este status intermediário, mostrando que está em processo de proteção, mas ainda não concluída.
| String
|-
| Protected
| Após a conclusão do pedido de solicitação de proteção da imagem, o status da mesma deve ser alterado para este, mostrando que a imagem agora está protegida.
| String
|-
| UnprotectRequest
| Solicitação de abertura da imagem (desproteger).
| String
|-
| Unprotecting
| Processo intermediário, ainda não concluído, de abertura da imagem.
| String
|-
| Unprotected
| Mostra que a imagem está agora, aberta (desprotegida).
| String
|}

== Request ==

=== Parâmetros ===
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| k4Chave
| Código k4 de um dispositivo
| String
|}

=== Header ===
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| Content-Type
| application/json
| String
|-
| Authorization
| Basic Authentication
| Auth
|-
| k1
| K1 Chave
| String
|}

=== Corpo ===

Não há informação no corpo

=== Exemplo ===

http://bluemonitor-teste.devedu.ms/BlueMonitorAPI/api/v1/ImageProtection/885246744077074624

== Response ==

=== Http Status Code ===
{| class="wikitable"
|-
! Código
! Nome
! Descrição
|-
| 200
| OK
|
|-
| 500
| InternalServerError
| Erro inesperado
|}

=== Corpo ===

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| K4Chave
| Chave do dispositivo (máquina)
| String
|-
| StatusImagem
| Situação da imagem naquele dispositivo.
| String
|-
| KpiPossuiUpdrive
| Retorna se um dispositivo possui updrive instalado, para controle no blueMonitor
| Bool
|-
| KpiSituacao
| Mostra situação do registro (1 = ativo; 2 = inativo; 3 = excluído)
| Byte
|}

=== Exemplo ===

{
"K4Chave": "885246744077074624",
"StatusImagem": "Protected",
"KpiPossuiUpdrive": true,
"KpiSituacao": 2
}

BMAPI GET api/v1/ImageProtection/(k4Chave)

2017-11-14T20:55:53Z

Ruz: Criou página com 'BlueMonitorAPI > Devices Image Protection == Request == === Parâmetros === {| class="wikitable" |- ! Nome ! Descrição ! Tip...'

[[BlueMonitorAPI]] > [[BlueMonitorAPI#Device Image Protection|Devices Image Protection]]

== Request ==

=== Parâmetros ===
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| k4Chave
| Código k4 de um dispositivo
| String
|}

=== Header ===
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| Content-Type
| application/json
| String
|-
| Authorization
| Basic Authentication
| Auth
|-
| k1
| K1 Chave
| String
|}

=== Corpo ===

Não há informação no corpo

=== Exemplo ===

http://bluemonitor-teste.devedu.ms/BlueMonitorAPI/api/v1/ImageProtection/885246744077074624

== Response ==

=== Http Status Code ===
{| class="wikitable"
|-
! Código
! Nome
! Descrição
|-
| 200
| OK
|
|-
| 500
| InternalServerError
| Erro inesperado
|}

=== Corpo ===

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| K4Chave
| Chave do dispositivo (máquina)
| String
|-
| StatusImagem
| Situação da imagem naquele dispositivo.
| String
|-
| KpiPossuiUpdrive
| Retorna se um dispositivo possui updrive instalado, para controle no blueMonitor
| Bool
|-
| KpiSituacao
| Mostra situação do registro (1 = ativo; 2 = inativo; 3 = excluído)
| Byte
|}

=== Exemplo ===

{
"K4Chave": "885246744077074624",
"StatusImagem": "Protected",
"KpiPossuiUpdrive": true,
"KpiSituacao": 2
}

BlueMonitorAPI

2017-11-14T20:28:25Z

Ruz:

== CategoriesTree ==

'''[[BMAPI GET api/v1/categoriesTree/(k1Chave)|GET api/v1/categoriesTree/{k1Chave}]]'''
Retorna uma arvore com todas as categorias e unidades administrativas que compõe toda a estrutura de localizações do domínio.

== Devices ==
'''[[BMAPI POST api/v1/devices|POST api/v1/devices]]'''
Cadastra uma máquina no BlueMonitor

== Devices Signals ==
'''[[BMAPI POST api/v1/devices/(k4Chave)/signals|POST api/v1/devices/{k4Chave}/signals]]'''
Registra a atualização do sinal da máquina, indicando que a mesma está ligada

== Devices TurnOff ==
'''[[BMAPI GET api/v1/devices/(k4Chave)/turnoff|GET api/v1/devices/{k4Chave}/turnoff]]'''
Retorna se a máquina deve desligar

'''[[BMAPI POST api/v1/devices/(k4Chave)/turnoff|POST api/v1/devices/{k4Chave}/turnoff]]'''
Registra que a máquina está desligando

== Devices Updates ==
'''[[BMAPI GET api/v1/devices/(k4Chave)/updates|GET api/v1/devices/{k4Chave}/updates]]'''
Retorna os updates associados à máquina

== Devices Updates Status ==
'''[[BMAPI POST api/v1/devices/(k4Chave)/updates/(updateId)/status|POST api/v1/devices/{k4Chave}/updates/{updateId}/status]]'''
Cadastra um novo status de atualização entre um update e uma máquina

'''[[BMAPI PUT api/v1/devices/(k4Chave)/updates/(updateId)/status/(id)|PUT api/v1/devices/{k4Chave}/updates/{updateId}/status/{id}]]'''
Atualiza um status de atualização entre um update e uma máquina

== CIE Updates ==
'''[[BMAPI GET api/v1/administrativeunit/(cie)/(type?)/(id:int?)|GET api/v1/administrativeunit/{cie}/{type?}/{id:int?}]]'''
Retorna os updates associados à uma CIE, com um tipo de dispositivo específico opcional.

== Devices Types ==
'''[[BMAPI GET api/v1/deviceTypes|GET api/v1/deviceTypes]]'''
Retorna os Tipos de máquinas

== Domains Categories ==
'''[[BMAPI GET api/v1/domains/(k1Chave)/categories|GET api/v1/domains/{k1Chave}/categories]]'''
Retorna as categorias do domínio.

== Domains Categories AdministrativeUnits==
'''[[BMAPI GET api/v1/domains/(k1Chave)/categories/(categoriesId)/administrativeUnit|GET api/v1/domains/{k1Chave}/categories/{categoriesId}/administrativeUnit]]'''
Retorna as Unidades Administrativas que estão associadas à uma categoria do domínio.

== Device Image Protection ==
'''[[BMAPI GET api/v1/ImageProtection/(k4Chave)|GET api/v1/ImageProtection/{k4Chave}]]'''
Retorna dados sobre a proteção do update para uma máquina específica.

'''[[BMAPI POST api/v1/ImageProtection|POST api/v1/ImageProtection]]'''
Cria um novo registro referente a proteção de update de um dispositivo.

'''[[BMAPI PUT api/v1/ImageProtection|PUT api/v1/ImageProtection]]'''
Atualiza um registro referente a proteção de update de um dispositivo.

== Inventory ==

=== Ambientes ===
Configuração: Tabela ''PARAMETRO'' do BlueMonitor
==== Teste (painelAcessa) ====
http://192.168.46.3:9200
'''Btracker:''' /bluemonitorteste/report
'''Inventário software:''' inventorysoftwareteste
'''Inventário hardware:''' inventoryhardwareteste

==== Desenvolvimento ====
http://192.168.46.3:9200
'''Btracker:''' /bluemonitor/report
'''Inventário software:''' inventorysoftware
'''Inventário hardware:''' inventoryhardware

==== Demo ====
http://demo-kibana.mstech.com.br
http://demo-logstash.mstech.com.br
http://demo-elasticsearch.mstech.com.br
'''Btracker:''' /bluemonitordemo/report
'''Inventário software:''' inventorysoftwaredemo
'''Inventário hardware:''' inventoryhardwaredemo

==== Chamadas API ====
'''[[BMAPI POST api/v1/inventoryhardware/|POST api/v1/inventoryhardware/]]'''
Envia um inventário para o ElasticSearch através do BlueMonitor.

'''[[BMAPI POST api/v1/inventorysoftware/|POST api/v1/inventorysoftware/]]'''
Envia um inventário para o ElasticSearch através do BlueMonitor.

BlueMonitorAPI

2017-11-13T11:47:25Z

Ruz: /* Ambientes */

== CategoriesTree ==

'''[[BMAPI GET api/v1/categoriesTree/(k1Chave)|GET api/v1/categoriesTree/{k1Chave}]]'''
Retorna uma arvore com todas as categorias e unidades administrativas que compõe toda a estrutura de localizações do domínio.

== Devices ==
'''[[BMAPI POST api/v1/devices|POST api/v1/devices]]'''
Cadastra uma máquina no BlueMonitor

== Devices Signals ==
'''[[BMAPI POST api/v1/devices/(k4Chave)/signals|POST api/v1/devices/{k4Chave}/signals]]'''
Registra a atualização do sinal da máquina, indicando que a mesma está ligada

== Devices TurnOff ==
'''[[BMAPI GET api/v1/devices/(k4Chave)/turnoff|GET api/v1/devices/{k4Chave}/turnoff]]'''
Retorna se a máquina deve desligar

'''[[BMAPI POST api/v1/devices/(k4Chave)/turnoff|POST api/v1/devices/{k4Chave}/turnoff]]'''
Registra que a máquina está desligando

== Devices Updates ==
'''[[BMAPI GET api/v1/devices/(k4Chave)/updates|GET api/v1/devices/{k4Chave}/updates]]'''
Retorna os updates associados à máquina

== Devices Updates Status ==
'''[[BMAPI POST api/v1/devices/(k4Chave)/updates/(updateId)/status|POST api/v1/devices/{k4Chave}/updates/{updateId}/status]]'''
Cadastra um novo status de atualização entre um update e uma máquina

'''[[BMAPI PUT api/v1/devices/(k4Chave)/updates/(updateId)/status/(id)|PUT api/v1/devices/{k4Chave}/updates/{updateId}/status/{id}]]'''
Atualiza um status de atualização entre um update e uma máquina

== CIE Updates ==
'''[[BMAPI GET api/v1/administrativeunit/(cie)/(type?)/(id:int?)|GET api/v1/administrativeunit/{cie}/{type?}/{id:int?}]]'''
Retorna os updates associados à uma CIE, com um tipo de dispositivo específico opcional.

== Devices Types ==
'''[[BMAPI GET api/v1/deviceTypes|GET api/v1/deviceTypes]]'''
Retorna os Tipos de máquinas

== Domains Categories ==
'''[[BMAPI GET api/v1/domains/(k1Chave)/categories|GET api/v1/domains/{k1Chave}/categories]]'''
Retorna as categorias do domínio.

== Domains Categories AdministrativeUnits==
'''[[BMAPI GET api/v1/domains/(k1Chave)/categories/(categoriesId)/administrativeUnit|GET api/v1/domains/{k1Chave}/categories/{categoriesId}/administrativeUnit]]'''
Retorna as Unidades Administrativas que estão associadas à uma categoria do domínio.

== Inventory ==

=== Ambientes ===
Configuração: Tabela ''PARAMETRO'' do BlueMonitor
==== Teste (painelAcessa) ====
http://192.168.46.3:9200
'''Btracker:''' /bluemonitorteste/report
'''Inventário software:''' inventorysoftwareteste
'''Inventário hardware:''' inventoryhardwareteste

==== Desenvolvimento ====
http://192.168.46.3:9200
'''Btracker:''' /bluemonitor/report
'''Inventário software:''' inventorysoftware
'''Inventário hardware:''' inventoryhardware

==== Demo ====
http://demo-kibana.mstech.com.br
http://demo-logstash.mstech.com.br
http://demo-elasticsearch.mstech.com.br
'''Btracker:''' /bluemonitordemo/report
'''Inventário software:''' inventorysoftwaredemo
'''Inventário hardware:''' inventoryhardwaredemo

==== Chamadas API ====
'''[[BMAPI POST api/v1/inventoryhardware/|POST api/v1/inventoryhardware/]]'''
Envia um inventário para o ElasticSearch através do BlueMonitor.

'''[[BMAPI POST api/v1/inventorysoftware/|POST api/v1/inventorysoftware/]]'''
Envia um inventário para o ElasticSearch através do BlueMonitor.

BlueMonitorAPI

2017-11-13T11:46:25Z

Ruz: /* CIE Updates */

== CategoriesTree ==

'''[[BMAPI GET api/v1/categoriesTree/(k1Chave)|GET api/v1/categoriesTree/{k1Chave}]]'''
Retorna uma arvore com todas as categorias e unidades administrativas que compõe toda a estrutura de localizações do domínio.

== Devices ==
'''[[BMAPI POST api/v1/devices|POST api/v1/devices]]'''
Cadastra uma máquina no BlueMonitor

== Devices Signals ==
'''[[BMAPI POST api/v1/devices/(k4Chave)/signals|POST api/v1/devices/{k4Chave}/signals]]'''
Registra a atualização do sinal da máquina, indicando que a mesma está ligada

== Devices TurnOff ==
'''[[BMAPI GET api/v1/devices/(k4Chave)/turnoff|GET api/v1/devices/{k4Chave}/turnoff]]'''
Retorna se a máquina deve desligar

'''[[BMAPI POST api/v1/devices/(k4Chave)/turnoff|POST api/v1/devices/{k4Chave}/turnoff]]'''
Registra que a máquina está desligando

== Devices Updates ==
'''[[BMAPI GET api/v1/devices/(k4Chave)/updates|GET api/v1/devices/{k4Chave}/updates]]'''
Retorna os updates associados à máquina

== Devices Updates Status ==
'''[[BMAPI POST api/v1/devices/(k4Chave)/updates/(updateId)/status|POST api/v1/devices/{k4Chave}/updates/{updateId}/status]]'''
Cadastra um novo status de atualização entre um update e uma máquina

'''[[BMAPI PUT api/v1/devices/(k4Chave)/updates/(updateId)/status/(id)|PUT api/v1/devices/{k4Chave}/updates/{updateId}/status/{id}]]'''
Atualiza um status de atualização entre um update e uma máquina

== CIE Updates ==
'''[[BMAPI GET api/v1/administrativeunit/(cie)/(type?)/(id:int?)|GET api/v1/administrativeunit/{cie}/{type?}/{id:int?}]]'''
Retorna os updates associados à uma CIE, com um tipo de dispositivo específico opcional.

== Devices Types ==
'''[[BMAPI GET api/v1/deviceTypes|GET api/v1/deviceTypes]]'''
Retorna os Tipos de máquinas

== Domains Categories ==
'''[[BMAPI GET api/v1/domains/(k1Chave)/categories|GET api/v1/domains/{k1Chave}/categories]]'''
Retorna as categorias do domínio.

== Domains Categories AdministrativeUnits==
'''[[BMAPI GET api/v1/domains/(k1Chave)/categories/(categoriesId)/administrativeUnit|GET api/v1/domains/{k1Chave}/categories/{categoriesId}/administrativeUnit]]'''
Retorna as Unidades Administrativas que estão associadas à uma categoria do domínio.

== Inventory ==

== Ambientes ==
Configuração: Tabela ''PARAMETRO'' do BlueMonitor
=== Teste (painelAcessa) ===
http://192.168.46.3:9200
'''Btracker:''' /bluemonitorteste/report
'''Inventário software:''' inventorysoftwareteste
'''Inventário hardware:''' inventoryhardwareteste

=== Desenvolvimento ===
http://192.168.46.3:9200
'''Btracker:''' /bluemonitor/report
'''Inventário software:''' inventorysoftware
'''Inventário hardware:''' inventoryhardware

=== Demo ===
http://demo-kibana.mstech.com.br
http://demo-logstash.mstech.com.br
http://demo-elasticsearch.mstech.com.br
'''Btracker:''' /bluemonitordemo/report
'''Inventário software:''' inventorysoftwaredemo
'''Inventário hardware:''' inventoryhardwaredemo

=== Chamadas API ===
'''[[BMAPI POST api/v1/inventoryhardware/|POST api/v1/inventoryhardware/]]'''
Envia um inventário para o ElasticSearch através do BlueMonitor.

'''[[BMAPI POST api/v1/inventorysoftware/|POST api/v1/inventorysoftware/]]'''
Envia um inventário para o ElasticSearch através do BlueMonitor.

BMAPI GET api/v1/domains/(k1Chave)/categories/(categoriesId)/administrativeUnit

2017-11-10T20:22:17Z

Ruz: /* Request */

[[BlueMonitorAPI]] > [[BlueMonitorAPI#Domains Categories AdministrativeUnits|Domains Categories AdministrativeUnits]]

== Request ==

'''Parâmetros'''
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| k1Chave
| Chave k1 da Máquina
| String
|-
| categorieId
| Id da categoria
| Int
|-
| administrativeUnitSuperiorId
| Id da Unidade Administrativa Superior
| Guid
|}

'''Corpo'''

Não há informação no corpo

'''Exemplo'''

http://bluemonitor-teste.devedu.ms/BlueMonitorAPI/api/v1/domains/2BD9FBE573/categories/9/administrativeUnit

== Response ==

'''Http Status Code'''
{| class="wikitable"
|-
! Código
! Nome
! Descrição
|-
| 200
| OK
|
|-
| 412
| PreConditionFailed
| Chave k1 não informada
|-
| 404
| NotFound
| Chave k1 não encontrada ou Categoria não encontrada ou nenhuma categoria cadastrada
|-
| 500
| InternalServerError
| Erro inesperado
|}

'''Corpo'''

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| Name
| Nome da Categoria
| String
|-
| CategorieId
| Id da Categoria
| Int
|-
| AdministrativeUniId
| Id da Unidade Administrativa
| Guid
|-
| AdministrativeUnitTypeId
| Id do Tipo de Unidade Administrativa
| Guid
|}

'''Exemplo'''

[
{
"Name": "FDE - SAI",
"CategorieId": 5,
"AdministrativeUnitId": null,
"AdministrativeUnitTypeId": null
}
]

BMAPI GET api/v1/domains/(k1Chave)/categories

2017-11-10T20:22:03Z

Ruz: /* Request */

[[BlueMonitorAPI]] > [[BlueMonitorAPI#Domains Categories|Domains Categories]]

== Request ==

'''Parâmetros'''
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| k1Chave
| Chave k1 da Máquina
| String
|-
| categorieSuperiorId
| Id da categoria superior (opcional)
| Int
|}

'''Corpo'''

Não há informação no corpo

'''Exemplo'''

http://bluemonitor-teste.devedu.ms/BlueMonitorAPI/api/v1/domains/2BD9FBE573/categories

== Response ==

'''Http Status Code'''
{| class="wikitable"
|-
! Código
! Nome
! Descrição
|-
| 200
| OK
|
|-
| 412
| PreConditionFailed
| Chave k1 não informada
|-
| 404
| NotFound
| Chave k1 não encontrada ou Categoria não encontrada ou nenhuma categoria cadastrada
|-
| 500
| InternalServerError
| Erro inesperado
|}

'''Corpo'''

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| Name
| Nome da Categoria
| String
|-
| CategorieId
| Id da Categoria
| Int
|-
| AdministrativeUniId
| Id da Unidade Administrativa
| Guid
|-
| AdministrativeUnitTypeId
| Id do Tipo de Unidade Administrativa
| Guid
|}

'''Exemplo'''

[
{
"Name": "FDE - SAI",
"CategorieId": 5,
"AdministrativeUnitId": null,
"AdministrativeUnitTypeId": null
}
]

BMAPI GET api/v1/deviceTypes

2017-11-10T20:21:49Z

Ruz: /* Request */

[[BlueMonitorAPI]] > [[BlueMonitorAPI#Devices Types|Devices Types]]

== Request ==

'''Parâmetros'''

Não há parâmetros

'''Corpo'''

Não há informação no corpo

'''Exemplo'''

http://bluemonitor-teste.devedu.ms/BlueMonitorAPI/api/v1/DeviceTypes

== Response ==

'''Http Status Code'''
{| class="wikitable"
|-
! Código
! Nome
! Descrição
|-
| 200
| OK
|
|-
| 500
| InternalServerError
| Erro inesperado
|}

'''Corpo'''

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| Id
| Id do tipo de máquina
| integer
|-
| Description
| Nome do tipo de máquina
| String
|}

'''Exemplo'''
[
{
"Id": 1,
"Description": "Servidor"
},
{
"Id": 2,
"Description": "Notebook"
}
]

BMAPI GET api/v1/devices/(k4Chave)/updates

2017-11-10T20:21:30Z

Ruz: /* Request */

[[BlueMonitorAPI]] > [[BlueMonitorAPI#Devices Updates|Devices Updates]]

== Request ==

'''Parâmetros'''
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| k4Chave
| Chave k4 da Máquina
| String
|}

'''Corpo'''

Não há informação no corpo

'''Exemplo'''

http://bluemonitor-teste.devedu.ms/BlueMonitorAPI/api/v1/Devices/188945718961311/updates

== Response ==

'''Http Status Code'''
{| class="wikitable"
|-
! Código
! Nome
! Descrição
|-
| 200
| OK
|
|-
| 412
| PreConditionFailed
| Chave k4 não informada
|-
| 404
| NotFound
| Chave k4 não encontrada
|-
| 500
| InternalServerError
| Erro inesperado
|}

'''Corpo'''

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| Id
| Id do update
| integer
|-
| Name
| Nome do Update
| String
|-
| Description
| Descrição do update
| String
|-
| Url
| Url para download do update
| String
|-
| Hash
| Hash do arquivo de download do update para validação
| String
|-
| Serial
| Serial que pertence o Update para ordenação de instalação
| String
|-
| VersionMajor
| Número da versão maior dentro de um Serial que pertence o Update para ordenação de instalação
| integer
|-
| VersionMinor
| Número da versão menor dentro de um Serial que pertence o Update para ordenação de instalação
| integer
|-
| VersionBuild
| Número da versão build dentro de um Serial que pertence o Update para ordenação de instalação
| integer
|-
| updNomeArquivoInstall
| Nome do arquivo de instalção
| String
|-
| updNomeArquivoUninstall
| Nome do arquivo de desinstalação
| String
|-
| updComandoInstall
| Argumentos para serem passados para o arquivo de instalação
| String
|-
| updComandoUninstall
| Argumentos para serem passados para o arquivo de desinstalação
| String
|}

'''Exemplo'''
[
{
"Id": 299,
"Name": "NotePad++",
"Description": "NotePad++",
"Url": "http://painelacessa.hominterna.fde.devedu.ms/BlueMonitorSSO/Updates/npp.6.9.2.Installer_2016-09-12_15-15-37.exe",
"Hash": "c0c9a1fd2c110723e5d18e00cfe79453",
"Serial": null,
"VersionMajor": 0,
"VersionMinor": 0,
"VersionBuild": 0,
"updNomeArquivoInstall": null,
"updNomeArquivoUninstall": null,
"updComandoInstall": null,
"updComandoUninstall": null,
}
]

BMAPI POST api/v1/devices/(k4Chave)/turnoff

2017-11-10T20:21:16Z

Ruz: /* Request */

[[BlueMonitorAPI]] > [[BlueMonitorAPI#Devices TurnOff|Devices TurnOff]]

== Request ==

'''Parâmetros'''
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| k4Chave
| Chave k4 da Máquina
| String
|}

'''Corpo'''

Não há informação no corpo

'''Exemplo'''

http://bluemonitor-teste.devedu.ms/BlueMonitorAPI/api/v1/devices/977574563645916670/turnOff

== Response ==

'''Http Status Code'''
{| class="wikitable"
|-
! Código
! Nome
! Descrição
|-
| 201
| Created
|
|-
| 412
| PreConditionFailed
| Chave k4 não informada
|-
| 404
| NotFound
| Chave k4 não encontrada ou Computador não encontrado
|-
| 500
| InternalServerError
| Erro inesperado
|}

'''Corpo'''

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| K4Chave
| K4 Chave da máquina
| String
|-
| TurnOff
| Determina se a máquina deve ser desligada ou não
| Boolean
|-
| TurnOffDate
| Data do commando de desligar máquina
| DateTime
|}

'''Exemplo'''
{
"K4Chave": "224",
"TurnOff": false,
"TurnOffDate": "0001-01-01T00:00:00"
}

BMAPI GET api/v1/devices/(k4Chave)/turnoff

2017-11-10T20:21:03Z

Ruz: /* Request */

[[BlueMonitorAPI]] > [[BlueMonitorAPI#Devices TurnOff|Devices TurnOff]]

== Request ==

'''Parâmetros'''
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| k4Chave
| Chave k4 da Máquina
| String
|}

'''Corpo'''

Não há informação no corpo

'''Exemplo'''

http://bluemonitor-teste.devedu.ms/BlueMonitorAPI/api/v1/devices/977574563645916670/turnOff

== Response ==

'''Http Status Code'''
{| class="wikitable"
|-
! Código
! Nome
! Descrição
|-
| 200
| OK
|
|-
| 412
| PreConditionFailed
| Chave k4 não informada
|-
| 404
| NotFound
| Chave k4 não encontrada ou Computador não encontrado
|-
| 500
| InternalServerError
| Erro inesperado
|}

'''Corpo'''

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| K4Chave
| K4 Chave da máquina
| String
|-
| TurnOff
| Determina se a máquina deve ser desligada ou não
| Boolean
|-
| TurnOffDate
| Data do commando de desligar máquina
| DateTime
|}

'''Exemplo'''
{
"K4Chave": "224",
"TurnOff": false,
"TurnOffDate": "0001-01-01T00:00:00"
}

BMAPI GET api/v1/categoriesTree/(k1Chave)

2017-11-10T20:20:04Z

Ruz: /* Request */

[[BlueMonitorAPI]] > [[BlueMonitorAPI#CategoriesTree|CategoriesTree]]

== Request ==

'''Parâmetros'''
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| k1Chave
| Chave k1 do Domínio
| String
|}

'''Corpo'''

Não há informação no corpo

'''Exemplo'''

http://bluemonitor-teste.devedu.ms/BlueMonitorAPI/api/v1/categoriesTree/2BD9FBE573

== Response ==

'''Http Status Code'''
{| class="wikitable"
|-
! Código
! Nome
! Descrição
|-
| 200
| OK
|
|-
| 412
| PreConditionFailed
| Chave k1 não informada
|-
| 404
| NotFound
| Chave k1 não encontrada ou estrutura de categorias não encontrada para o domínio
|-
| 500
| InternalServerError
| Erro inesperado
|}

'''Corpo'''

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| Id
| Id da categoria
| integer
|-
| Description
| Descrição da categoria
| String
|-
| UadId
| Id da Unidade Administrativa
| Guid
|-
| ChildCategoriesTree
| Lista de categorias filho desta categoria
| Collection of CategoriesTree
|}

'''Exemplo'''
{
"Id": 5,
"Description": "Bauru",
"UadId": null,
"ChildCategoriesTree": [
{
"Id": 6,
"Description": "Secretaria",
"UadId": null,
"ChildCategoriesTree": [
{
"Id": 6,
"Description": "Secretaria Municipal de Bauru",
"UadId": "78feab9f-1659-e311-95c5-b8ac6fb2d553",
"ChildCategoriesTree": [
{
"Id": 7,
"Description": "Escolas",
"UadId": "78feab9f-1659-e311-95c5-b8ac6fb2d553",
"ChildCategoriesTree": [
{
"Id": 7,
"Description": "Escola 1",
"UadId": "c3a183aa-1659-e311-95c5-b8ac6fb2d553",
"ChildCategoriesTree": [
{
"Id": 8,
"Description": "Lab. de Informatica",
"UadId": "c3a183aa-1659-e311-95c5-b8ac6fb2d553",
"ChildCategoriesTree": null
}
]
},
{
"Id": 7,
"Description": "Escola 2",
"UadId": "19a283aa-1659-e311-95c5-b8ac6fb2d553",
"ChildCategoriesTree": [
{
"Id": 8,
"Description": "Lab. de Informatica",
"UadId": "19a283aa-1659-e311-95c5-b8ac6fb2d553",
"ChildCategoriesTree": null
}
]
}
]
}
]
}
]
}
]
}

BMAPI GET api/v1/administrativeunit/(cie)/(type?)/(id:int?)

2017-11-09T18:26:39Z

Ruz:

[[BlueMonitorAPI]] > [[BlueMonitorAPI#Devices Updates|Devices Updates]]

== Request ==

=== Parâmetros ===
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| cie
| Código CIE da escola (uad_codigo)
| String
|-
| id
| (opcional) ID do tipo de dispositivo (typeID)
| Int
|}

=== Header ===
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| Content-Type
| application/json
| String
|-
| Authorization
| Basic Authentication
| Auth
|-
| k1
| K1 Chave
| String
|}

=== Corpo ===

Não há informação no corpo

=== Exemplo ===

http://bluemonitor-teste.devedu.ms/BlueMonitorAPI/api/v1/administrativeunit/124/type/1

ou (busca por todos os tipos)
http://bluemonitor-teste.devedu.ms/BlueMonitorAPI/api/v1/administrativeunit/124

== Response ==

=== Http Status Code ===
{| class="wikitable"
|-
! Código
! Nome
! Descrição
|-
| 200
| OK
|
|-
| 500
| InternalServerError
| Erro inesperado
|}

=== Corpo ===

Composto de 2 grupos de dados: Updates e Associações:

==== DevicesUpdates ====

Referente aos dados de cada update utilizado nas associações desta CIE:

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| Id
| Id do update
| integer
|-
| Name
| Nome do Update
| String
|-
| Description
| Descrição do update
| String
|-
| Url
| Url para download do update
| String
|-
| Hash
| Hash do arquivo de download do update para validação
| String
|-
| Serial
| Serial que pertence o Update para ordenação de instalação
| String
|-
| VersionMajor
| Número da versão maior dentro de um Serial que pertence o Update para ordenação de instalação
| integer
|-
| VersionMinor
| Número da versão menor dentro de um Serial que pertence o Update para ordenação de instalação
| integer
|-
| VersionBuild
| Número da versão build dentro de um Serial que pertence o Update para ordenação de instalação
| integer
|-
| updNomeArquivoInstall
| Nome do arquivo de instalção
| String
|-
| updNomeArquivoUninstall
| Nome do arquivo de desinstalação
| String
|-
| updComandoInstall
| Argumentos para serem passados para o arquivo de instalação
| String
|-
| updComandoUninstall
| Argumentos para serem passados para o arquivo de desinstalação
| String
|}

==== UpdateBindings ====

Referente às associações de cada update:

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| UpdID
| Id do update
| integer
|-
| K1Chave
| Chave K1 (domínio)
| String
|-
| K4Chave
| Chave K4 (máquina)
| String
|-
| TipoID
| ID do tipo de dispositivo que recebeu update (nulo em caso de k4)
| Int
|-
| CatID
| ID da categoria do domínio ou unidade (ex: laboratório, escola, cantina, diretoria)
| Int
|}

=== Exemplo ===

{
"DevicesUpdates": [
{
"DownloadDateRestriction": false,
"InstallAutomatically": false,
"Id": 0,
"Name": null,
"Description": null,
"Url": null,
"Hash": null,
"Serial": null,
"VersionMajor": 0,
"VersionMinor": 0,
"VersionBuild": 0,
"updNomeArquivoInstall": "ins",
"updNomeArquivoUninstall": "des",
"updComandoInstall": "ins",
"updComandoUninstall": "des",
"MaxRetryDownload": 0,
"MaxRetryExecution": 0,
"SoID": 0,
"SoDescricao": null,
"SoVersao": null
},
{
"DownloadDateRestriction": false,
"InstallAutomatically": false,
"Id": 0,
"Name": null,
"Description": null,
"Url": null,
"Hash": null,
"Serial": null,
"VersionMajor": 0,
"VersionMinor": 0,
"VersionBuild": 0,
"updNomeArquivoInstall": "ni2",
"updNomeArquivoUninstall": "nd2",
"updComandoInstall": "ci2",
"updComandoUninstall": "cd2",
"MaxRetryDownload": 0,
"MaxRetryExecution": 0,
"SoID": 0,
"SoDescricao": null,
"SoVersao": null
},
{
"DownloadDateRestriction": false,
"InstallAutomatically": false,
"Id": 0,
"Name": null,
"Description": null,
"Url": null,
"Hash": null,
"Serial": null,
"VersionMajor": 0,
"VersionMinor": 0,
"VersionBuild": 0,
"updNomeArquivoInstall": "inst",
"updNomeArquivoUninstall": "inst",
"updComandoInstall": "inst",
"updComandoUninstall": "inst",
"MaxRetryDownload": 0,
"MaxRetryExecution": 0,
"SoID": 0,
"SoDescricao": null,
"SoVersao": null
}
],
"UpdateBindings": [
{
"UpdID": 345,
"K1Chave": "teste1",
"K4Chave": null,
"TipoID": 1,
"CatID": 1348
},
{
"UpdID": 335,
"K1Chave": "teste1",
"K4Chave": null,
"TipoID": 1,
"CatID": 1350
},
{
"UpdID": 346,
"K1Chave": "teste1",
"K4Chave": null,
"TipoID": 1,
"CatID": 1348
},
{
"UpdID": 1346,
"K1Chave": "teste1",
"K4Chave": null,
"TipoID": 1,
"CatID": 1348
},
{
"UpdID": 175,
"K1Chave": "teste1",
"K4Chave": null,
"TipoID": 1,
"CatID": 1377
},
{
"UpdID": 326,
"K1Chave": "teste1",
"K4Chave": null,
"TipoID": 1,
"CatID": 1371
},
{
"UpdID": 335,
"K1Chave": "teste1",
"K4Chave": null,
"TipoID": 1,
"CatID": 1350
},
{
"UpdID": 288,
"K1Chave": "teste1",
"K4Chave": "885246744077074624",
"TipoID": null,
"CatID": null
},
{
"UpdID": 1350,
"K1Chave": "teste1",
"K4Chave": "885246744077074624",
"TipoID": null,
"CatID": null
}
]
}

BMAPI GET api/v1/administrativeunit/(cie)/(type?)/(id:int?)

2017-11-09T18:22:41Z

Ruz:

[[BlueMonitorAPI]] > [[BlueMonitorAPI#Devices Updates|Devices Updates]]

== Request ==

'''Parâmetros'''
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| cie
| Código CIE da escola (uad_codigo)
| String
|-
| id
| (opcional) ID do tipo de dispositivo (typeID)
| Int
|}

'''Header'''
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| Content-Type
| application/json
| String
|-
| Authorization
| Basic Authentication
| Auth
|-
| k1
| K1 Chave
| String
|}

'''Corpo'''

Não há informação no corpo

'''Exemplo'''

http://bluemonitor-teste.devedu.ms/BlueMonitorAPI/api/v1/administrativeunit/124/type/1

ou (busca por todos os tipos)
http://bluemonitor-teste.devedu.ms/BlueMonitorAPI/api/v1/administrativeunit/124

== Response ==

'''Http Status Code'''
{| class="wikitable"
|-
! Código
! Nome
! Descrição
|-
| 200
| OK
|
|-
| 500
| InternalServerError
| Erro inesperado
|}

'''Corpo'''

Composto de 2 grupos de dados: Updates e Associações:

'''Updates:'''

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| Id
| Id do update
| integer
|-
| Name
| Nome do Update
| String
|-
| Description
| Descrição do update
| String
|-
| Url
| Url para download do update
| String
|-
| Hash
| Hash do arquivo de download do update para validação
| String
|-
| Serial
| Serial que pertence o Update para ordenação de instalação
| String
|-
| VersionMajor
| Número da versão maior dentro de um Serial que pertence o Update para ordenação de instalação
| integer
|-
| VersionMinor
| Número da versão menor dentro de um Serial que pertence o Update para ordenação de instalação
| integer
|-
| VersionBuild
| Número da versão build dentro de um Serial que pertence o Update para ordenação de instalação
| integer
|-
| updNomeArquivoInstall
| Nome do arquivo de instalção
| String
|-
| updNomeArquivoUninstall
| Nome do arquivo de desinstalação
| String
|-
| updComandoInstall
| Argumentos para serem passados para o arquivo de instalação
| String
|-
| updComandoUninstall
| Argumentos para serem passados para o arquivo de desinstalação
| String
|}

'''Associações'''

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| UpdID
| Id do update
| integer
|-
| K1Chave
| Chave K1 (domínio)
| String
|-
| K4Chave
| Chave K4 (máquina)
| String
|-
| TipoID
| ID do tipo de dispositivo que recebeu update (nulo em caso de k4)
| Int
|-
| CatID
| ID da categoria do domínio ou unidade (ex: laboratório, escola, cantina, diretoria)
| Int
|}

'''Exemplo'''

{
"DevicesUpdates": [
{
"DownloadDateRestriction": false,
"InstallAutomatically": false,
"Id": 0,
"Name": null,
"Description": null,
"Url": null,
"Hash": null,
"Serial": null,
"VersionMajor": 0,
"VersionMinor": 0,
"VersionBuild": 0,
"updNomeArquivoInstall": "ins",
"updNomeArquivoUninstall": "des",
"updComandoInstall": "ins",
"updComandoUninstall": "des",
"MaxRetryDownload": 0,
"MaxRetryExecution": 0,
"SoID": 0,
"SoDescricao": null,
"SoVersao": null
},
{
"DownloadDateRestriction": false,
"InstallAutomatically": false,
"Id": 0,
"Name": null,
"Description": null,
"Url": null,
"Hash": null,
"Serial": null,
"VersionMajor": 0,
"VersionMinor": 0,
"VersionBuild": 0,
"updNomeArquivoInstall": "ni2",
"updNomeArquivoUninstall": "nd2",
"updComandoInstall": "ci2",
"updComandoUninstall": "cd2",
"MaxRetryDownload": 0,
"MaxRetryExecution": 0,
"SoID": 0,
"SoDescricao": null,
"SoVersao": null
},
{
"DownloadDateRestriction": false,
"InstallAutomatically": false,
"Id": 0,
"Name": null,
"Description": null,
"Url": null,
"Hash": null,
"Serial": null,
"VersionMajor": 0,
"VersionMinor": 0,
"VersionBuild": 0,
"updNomeArquivoInstall": "inst",
"updNomeArquivoUninstall": "inst",
"updComandoInstall": "inst",
"updComandoUninstall": "inst",
"MaxRetryDownload": 0,
"MaxRetryExecution": 0,
"SoID": 0,
"SoDescricao": null,
"SoVersao": null
}
],
"UpdateBindings": [
{
"UpdID": 345,
"K1Chave": "teste1",
"K4Chave": null,
"TipoID": 1,
"CatID": 1348
},
{
"UpdID": 335,
"K1Chave": "teste1",
"K4Chave": null,
"TipoID": 1,
"CatID": 1350
},
{
"UpdID": 346,
"K1Chave": "teste1",
"K4Chave": null,
"TipoID": 1,
"CatID": 1348
},
{
"UpdID": 1346,
"K1Chave": "teste1",
"K4Chave": null,
"TipoID": 1,
"CatID": 1348
},
{
"UpdID": 175,
"K1Chave": "teste1",
"K4Chave": null,
"TipoID": 1,
"CatID": 1377
},
{
"UpdID": 326,
"K1Chave": "teste1",
"K4Chave": null,
"TipoID": 1,
"CatID": 1371
},
{
"UpdID": 335,
"K1Chave": "teste1",
"K4Chave": null,
"TipoID": 1,
"CatID": 1350
},
{
"UpdID": 288,
"K1Chave": "teste1",
"K4Chave": "885246744077074624",
"TipoID": null,
"CatID": null
},
{
"UpdID": 1350,
"K1Chave": "teste1",
"K4Chave": "885246744077074624",
"TipoID": null,
"CatID": null
}
]
}

BMAPI GET api/v1/administrativeunit/(cie)/(type?)/(id:int?)

2017-11-09T18:22:25Z

Ruz:

BMAPI GET api/v1/administrativeunit/(cie)/(type?)/(id:int?)

2017-11-09T18:11:22Z

Ruz:

[[BlueMonitorAPI]] > [[BlueMonitorAPI#Devices Updates|Devices Updates]]

== Request ==

'''Parâmetros'''
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| cie
| Código CIE da escola (uad_codigo)
| String
|-
| id
| (opcional) ID do tipo de dispositivo (typeID)
| Int
|}

'''Header'''
{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| Content-Type
| application/json
| String
|-
| Authorization
| Basic Authentication
| Auth
|-
| k1
| K1 Chave
| String
|}

'''Corpo'''

Não há informação no corpo

'''Exemplo'''

http://bluemonitor-teste.devedu.ms/BlueMonitorAPI/api/v1/administrativeunit/124/type/1

ou (busca por todos os tipos)
http://bluemonitor-teste.devedu.ms/BlueMonitorAPI/api/v1/administrativeunit/124

== Response ==

'''Http Status Code'''
{| class="wikitable"
|-
! Código
! Nome
! Descrição
|-
| 200
| OK
|
|-
| 500
| InternalServerError
| Erro inesperado
|}

'''Corpo'''

Composto de 2 grupos de dados: Updates e Associações:

'''Updates:'''

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| Id
| Id do update
| integer
|-
| Name
| Nome do Update
| String
|-
| Description
| Descrição do update
| String
|-
| Url
| Url para download do update
| String
|-
| Hash
| Hash do arquivo de download do update para validação
| String
|-
| Serial
| Serial que pertence o Update para ordenação de instalação
| String
|-
| VersionMajor
| Número da versão maior dentro de um Serial que pertence o Update para ordenação de instalação
| integer
|-
| VersionMinor
| Número da versão menor dentro de um Serial que pertence o Update para ordenação de instalação
| integer
|-
| VersionBuild
| Número da versão build dentro de um Serial que pertence o Update para ordenação de instalação
| integer
|-
| updNomeArquivoInstall
| Nome do arquivo de instalção
| String
|-
| updNomeArquivoUninstall
| Nome do arquivo de desinstalação
| String
|-
| updComandoInstall
| Argumentos para serem passados para o arquivo de instalação
| String
|-
| updComandoUninstall
| Argumentos para serem passados para o arquivo de desinstalação
| String
|}

'''Associações'''

{| class="wikitable"
|-
! Nome
! Descrição
! Tipo
|-
| UpdID
| Id do update
| integer
|-
| K1Chave
| Chave K1 (domínio)
| String
|-
| K4Chave
| Chave K4 (máquina)
| String
|-
| TipoID
| ID do tipo de dispositivo que recebeu update (nulo em caso de k4)
| Int
|-
| CatID
| ID da categoria do domínio ou unidade (ex: laboratório, escola, cantina, diretoria)
| Int
|}

'''Exemplo'''
{
"DevicesUpdates": [
{
"DownloadDateRestriction": false,
"InstallAutomatically": false,
"Id": 0,
"Name": null,
"Description": null,
"Url": null,
"Hash": null,
"Serial": null,
"VersionMajor": 0,
"VersionMinor": 0,
"VersionBuild": 0,
"updNomeArquivoInstall": "ins",
"updNomeArquivoUninstall": "des",
"updComandoInstall": "ins",
"updComandoUninstall": "des",
"MaxRetryDownload": 0,
"MaxRetryExecution": 0,
"SoID": 0,
"SoDescricao": null,
"SoVersao": null
},
{
"DownloadDateRestriction": false,
"InstallAutomatically": false,
"Id": 0,
"Name": null,
"Description": null,
"Url": null,
"Hash": null,
"Serial": null,
"VersionMajor": 0,
"VersionMinor": 0,
"VersionBuild": 0,
"updNomeArquivoInstall": "ni2",
"updNomeArquivoUninstall": "nd2",
"updComandoInstall": "ci2",
"updComandoUninstall": "cd2",
"MaxRetryDownload": 0,
"MaxRetryExecution": 0,
"SoID": 0,
"SoDescricao": null,
"SoVersao": null
},
{
"DownloadDateRestriction": false,
"InstallAutomatically": false,
"Id": 0,
"Name": null,
"Description": null,
"Url": null,
"Hash": null,
"Serial": null,
"VersionMajor": 0,
"VersionMinor": 0,
"VersionBuild": 0,
"updNomeArquivoInstall": "inst",
"updNomeArquivoUninstall": "inst",
"updComandoInstall": "inst",
"updComandoUninstall": "inst",
"MaxRetryDownload": 0,
"MaxRetryExecution": 0,
"SoID": 0,
"SoDescricao": null,
"SoVersao": null
}
],
"UpdateBindings": [
{
"UpdID": 345,
"K1Chave": "teste1",
"K4Chave": null,
"TipoID": 1,
"CatID": 1348
},
{
"UpdID": 335,
"K1Chave": "teste1",
"K4Chave": null,
"TipoID": 1,
"CatID": 1350
},
{
"UpdID": 346,
"K1Chave": "teste1",
"K4Chave": null,
"TipoID": 1,
"CatID": 1348
},
{
"UpdID": 1346,
"K1Chave": "teste1",
"K4Chave": null,
"TipoID": 1,
"CatID": 1348
},
{
"UpdID": 175,
"K1Chave": "teste1",
"K4Chave": null,
"TipoID": 1,
"CatID": 1377
},
{
"UpdID": 326,
"K1Chave": "teste1",
"K4Chave": null,
"TipoID": 1,
"CatID": 1371
},
{
"UpdID": 335,
"K1Chave": "teste1",
"K4Chave": null,
"TipoID": 1,
"CatID": 1350
},
{
"UpdID": 288,
"K1Chave": "teste1",
"K4Chave": "885246744077074624",
"TipoID": null,
"CatID": null
},
{
"UpdID": 1350,
"K1Chave": "teste1",
"K4Chave": "885246744077074624",
"TipoID": null,
"CatID": null
}
]
}

BMAPI GET api/v1/administrativeunit/(cie)/(type?)/(id:int?)

2017-11-09T18:08:10Z

Ruz: /* Request */

BMAPI GET api/v1/administrativeunit/(cie)/(type?)/(id:int?)

2017-11-09T18:07:00Z

Ruz: Criou página com 'BlueMonitorAPI > Devices Updates == Request == '''Parâmetros''' {| class="wikitable" |- ! Nome ! Descrição ! Tipo |- | cie | Códig...'

BlueMonitorAPI

2017-11-09T15:27:53Z

Ruz:

== CategoriesTree ==

'''[[BMAPI GET api/v1/categoriesTree/(k1Chave)|GET api/v1/categoriesTree/{k1Chave}]]'''
Retorna uma arvore com todas as categorias e unidades administrativas que compõe toda a estrutura de localizações do domínio.

== Devices ==
'''[[BMAPI POST api/v1/devices|POST api/v1/devices]]'''
Cadastra uma máquina no BlueMonitor

== Devices Signals ==
'''[[BMAPI POST api/v1/devices/(k4Chave)/signals|POST api/v1/devices/{k4Chave}/signals]]'''
Registra a atualização do sinal da máquina, indicando que a mesma está ligada

== Devices TurnOff ==
'''[[BMAPI GET api/v1/devices/(k4Chave)/turnoff|GET api/v1/devices/{k4Chave}/turnoff]]'''
Retorna se a máquina deve desligar

'''[[BMAPI POST api/v1/devices/(k4Chave)/turnoff|POST api/v1/devices/{k4Chave}/turnoff]]'''
Registra que a máquina está desligando

== Devices Updates ==
'''[[BMAPI GET api/v1/devices/(k4Chave)/updates|GET api/v1/devices/{k4Chave}/updates]]'''
Retorna os updates associados à máquina

== Devices Updates Status ==
'''[[BMAPI POST api/v1/devices/(k4Chave)/updates/(updateId)/status|POST api/v1/devices/{k4Chave}/updates/{updateId}/status]]'''
Cadastra um novo status de atualização entre um update e uma máquina

'''[[BMAPI PUT api/v1/devices/(k4Chave)/updates/(updateId)/status/(id)|PUT api/v1/devices/{k4Chave}/updates/{updateId}/status/{id}]]'''
Atualiza um status de atualização entre um update e uma máquina

== CIE Updates ==
'''[[BMAPI GET api/v1/administrativeunit/(cie)/(type?)/(id:int?)|GET api/v1/administrativeunit/{cie}/{type?}/{id:int?}]]'''
Retorna os updates associados à uma CIE, com um tipo de dispositivo específico.

== Devices Types ==
'''[[BMAPI GET api/v1/deviceTypes|GET api/v1/deviceTypes]]'''
Retorna os Tipos de máquinas

== Domains Categories ==
'''[[BMAPI GET api/v1/domains/(k1Chave)/categories|GET api/v1/domains/{k1Chave}/categories]]'''
Retorna as categorias do domínio.

== Domains Categories AdministrativeUnits==
'''[[BMAPI GET api/v1/domains/(k1Chave)/categories/(categoriesId)/administrativeUnit|GET api/v1/domains/{k1Chave}/categories/{categoriesId}/administrativeUnit]]'''
Retorna as Unidades Administrativas que estão associadas à uma categoria do domínio.

== Inventory ==

== Ambientes ==
Configuração: Tabela ''PARAMETRO'' do BlueMonitor
=== Teste (painelAcessa) ===
http://192.168.46.3:9200
'''Btracker:''' /bluemonitorteste/report
'''Inventário software:''' inventorysoftwareteste
'''Inventário hardware:''' inventoryhardwareteste

=== Desenvolvimento ===
http://192.168.46.3:9200
'''Btracker:''' /bluemonitor/report
'''Inventário software:''' inventorysoftware
'''Inventário hardware:''' inventoryhardware

=== Demo ===
http://demo-kibana.mstech.com.br
http://demo-logstash.mstech.com.br
http://demo-elasticsearch.mstech.com.br
'''Btracker:''' /bluemonitordemo/report
'''Inventário software:''' inventorysoftwaredemo
'''Inventário hardware:''' inventoryhardwaredemo

=== Chamadas API ===
'''[[BMAPI POST api/v1/inventoryhardware/|POST api/v1/inventoryhardware/]]'''
Envia um inventário para o ElasticSearch através do BlueMonitor.

'''[[BMAPI POST api/v1/inventorysoftware/|POST api/v1/inventorysoftware/]]'''
Envia um inventário para o ElasticSearch através do BlueMonitor.

Ambientes

2017-11-08T13:59:36Z

Ruz: /* Testes internos */

== Desenvolvimento (Git e TFS) ==
=== BlueMonitor_SSO: ===
https://gitlab.mstech.com.br/bluemonitor/bluemonitorsso.git
(entidade: mstech - Central de Serviços)

BD: dev-sql16\DEV_BlueMonitor_SSO

=== BlueControlWeb ===
$/BlueControlWeb/Main/MSTech.BlueControlWEB-FDE-2008

BD: dev-sql16 -> DEV_BlueControlWeb

$/BlueControlWeb/dev/MSTech.BlueControlWEB-SSO-2008

BD: dev-sql16 -> DEV_BlueControlWeb_SSO

== Testes internos ==
=== TS-IIS03 - bluemonitorSSO (antiga fde) ===

http://coresso-bluemonitor-teste.devedu.ms/

http://bluemonitor-teste.devedu.ms/bluemonitorsso/default.aspx

BD: dev-sql16\pub_FDE_*

=== SMESP ===
CoreSSO: http://192.168.10.22:8100

BlueMonitor: http://192.168.10.22:8101

BD: dev-sql14cli\sme_bkp_*

=== testes (RJ ou Correios): ===
http://192.168.10.22:8001 (CoreSSO)

http://192.168.10.22:8002 (BlueMonitor)

http://192.168.10.22:8003 (Bluemonitor API)[[API]]

BD: ts-bd\RJ_BlueMonitor_SSO

login: admin, senha: 123456

=== Suporte MS ===
http://demonstracao.mstech.com.br
(admin, 123456)

== Demonstração: ==
=== Demonstração geral ===
http://demo.mstech.com.br
(adminbm, 123456)

=== Edital Paraiba ===
http://dpb.mstech.com.br (adminbm, 123456)

== Homologação ==
=== SME ===
http://h-coresso.sme.prefeitura.sp.gov.br/

=== FDE ===
(acesso por VPN)

http://coreblues.educacao.intragov

http://h-acessaescola.fde.sp.gov.br/BlueMonitorSSO

== Produção ==
=== SME ===
http://coresso.sme.prefeitura.sp.gov.br/

=== FDE ===
http://coreblues.educacao.sp.gov.br/

http://www.painelacessa.educacao.sp.gov.br/BlueControlWeb/index.aspx

http://www.painelacessa.educacao.sp.gov.br/BlueMonitorSSO/

Elastic Btracker

2017-11-07T19:17:36Z

Ruz: /* Ambientes */

== Ambientes ==
Configuração: Tabela ''PARAMETRO'' do BlueMonitor

https://wiki.mstech.com.br/index.php/BlueMonitorAPI#Inventory

== Aplicativos úteis ==
Sense - Google Chrome
https://chrome.google.com/webstore/detail/sense-beta/lhjgkmllcaadmopgmanpapmpjgmfcfig

Plugin client rest, parecido com o PostMan, facilita as queries para o elasticSearch

== Criando mapeamento (estrutura do índice) ==
Criando o índice chamado "bluemonitor", e o mapeamento chamado "report":

no Sense:

URL: http://192.168.46.12:9200
Body:

PUT bluemonitor
{
"aliases": {},
"mappings": {
"report": {
"properties": {
"activeWindowName": {
"type": "keyword"
},
"activeWindowTitle": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"diretoriaID": {
"type": "keyword"
},
"diretoriaName": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"finalUseTimeStamp": {
"type": "date"
},
"macAddress": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"peopleName": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"processList": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"schoolID": {
"type": "keyword"
},
"schoolName": {
"type": "keyword"
},
"systemOSVersion": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"timeSpent": {
"type": "long"
},
"userName": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"userType": {
"type": "keyword"
}
}
}
}
}

== Gravando um documento no formato Btracker no Elastic ==
Server (url): http://192.168.46.12:9200/

Body:

POST /bluemonitor/report
{
"userName": "marriely.garcia",
"peopleName": "",
"processList": null,
"activeWindowName": "chrome",
"activeWindowTitle": "Guia para geração de relatórios de bugs do Youtrack - MSTECH wiki - Google Chrome",
"macAddress": "00:00:00:00:00:00:00:E0 | 78:2B:CB:C3:1E:55 | 00:00:00:00:00:00:00:E0 | 00:15:5D:C4:73:C5 | ",
"finalUseTimeStamp": "2016-11-24T09:15:31Z",
"timeSpent": 1,
"systemOSVersion": "Windows 8.1 6.3",
"schoolID": "30333",
"schoolName": "ESCOLA DA VIDA ",
"schoolNameCode": "30333|||ESCOLA DA VIDA ",
"diretoriaID": "20111",
"diretoriaName": "BONIFACIO",
"userLogin": "Emerson",
"userType": "aluno"

}

== Apagando todos os documentos do mapeamento ==
Server (url): http://192.168.46.12:9200
body:

DELETE bluemonitor

== Listando registros (GET) ==
* no browser: http://192.168.46.3:9200/bluemonitor/report/_search
* no Sense:
(o sense considera os espaços e quebras de linha, caso tenha algo errado, ele não dá o comando)

GET bluemonitor/report/_search
{
"query": { "match_all": {} }
}

== Correção Erros ==
Caso o serviço não esteja iniciando, verificar primeiro:
1 - services.msc -> Serviço Elastic está iniciado?

1a - Se iniciar, atualize a tela do services.msc algumas vezes com o F5, se ele parar de rodar, é porque pode estar com incompatibilidade de IPs.

2 - Abrir o arquivo "elasticsearch.yml" NO WORDPAD (NÃO USAR NOTEPAD) em Elastic\config, vá para a última linha, verifique o IP, e se o mesmo pode ser usado. é o IP de saída, por onde as outras máquinas vão acessar o server elastic.

3 - Ir nas configurações de rede: Painel de Controle\Rede e Internet\Conexões de Rede
localize a rede ativa atual, botão direito -> Propriedades -> Protocolo TCP/IP Versão 4 (TCP/IPv4) -> Propriedades.

4 - Marcar: "usar o seguinte endereço de IP";
a - Endereço IP: (o mesmo do elasticsearch.yml): ex: 192.168.46.12
b - Máscara de sub-rede: 255.255.255.0
c - 192.168.46.1
d - Usar os seguintes endereços de servidor DNS -> servidor dns preferencial: 192.168.250.1

Caso não funcione, ou você não saiba o IP correto de saída, consulte o GTI.

== Introdução (Histórico e-mails) ==

Em 8 de fevereiro de 2017 13:36, Thiago Froes <thiago.froes@mstech.com.br> escreveu:
Olá Casella, tudo bem?

Segue abaixo a estrutura do índice que criamos nos ambiente de homologação e produção que obtiveram sucesso na execução dos relatórios:

/*******************************************************************************/
Criar Indice
/*******************************************************************************/

PUT bluemonitor
{
"aliases": {},
"mappings": {
"report": {
"properties": {
"activeWindowName": {
"type": "keyword"
},
"activeWindowTitle": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"diretoriaID": {
"type": "keyword"
},
"diretoriaName": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"finalUseTimeStamp": {
"type": "date"
},
"macAddress": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"peopleName": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"processList": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"schoolID": {
"type": "keyword"
},
"schoolName": {
"type": "keyword"
},
"systemOSVersion": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"timeSpent": {
"type": "long"
},
"userName": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"userType": {
"type": "keyword"
}
}
}
}
}

Obrigado

2016-12-27 17:50 GMT-02:00 André Ruz <andre.ruz@mstech.com.br>:
Depois que o Casella enviou pra mim o commando put que o btracker gera, suportando também o json que o Antônio enviou no e-mail abaixo:

PUT: http://10.17.15.150:9200/bluemonitor

{
"mappings":{
"report":{
"properties":{
"finalUseTimeStamp":{
"format":"dateOptionalTime",
"type":"date"
},
"processList":{
"index":"not_analyzed",
"type":"string"
},
"timeSpent":{
"type":"keyword"
},
"peopleName":{
"index":"not_analyzed",
"type":"string"
},
"systemOSVersion":{
"index":"not_analyzed",
"type":"string"
},
"diretoriaID":{
"index":"not_analyzed",
"type":"keyword"
},
"userName":{
"index":"not_analyzed",
"type":"string"
},
"schoolNameCode":{
"index":"not_analyzed",
"type":"string"
},
"activeWindowName":{
"index":"not_analyzed",
"type":"string"
},
"activeWindowTitle":{
"index":"not_analyzed",
"type":"string"
},
"userLogin":{
"index":"not_analyzed",
"type":"string"
},
"macAddress":{
"index":"not_analyzed",
"type":"string"
},
"diretoriaName":{
"index":"not_analyzed",
"type":"string"
},
"schoolID":{
"index":"not_analyzed",
"type":"keyword"
},
"userType":{
"index":"not_analyzed",
"type":"keyword"
},
"schoolName":{
"index":"not_analyzed",
"type":"string"
}
}
}
}
}

A configuração ocorreu com sucesso. Ainda temos pendente de um problema com um dos filtros que no nosso ambiente de backup funciona, mas na homologação ainda não deu certo. Fora isso, o retorno aparentemente mostrado na página foi realizado com sucesso.

André Ruz

Estratégias Tecnológicas

Cel. +55 14 98809-8569
Tel. +55 14 3235-5500
mstech [ www.mstech.com.br ]

Antes de imprimir, pense em sua
responsabilidade com o meio ambiente

De: Bruno Fernandes Casella [mailto:bruno.casella@mstech.com.br]
Enviada em: terça-feira, 27 de dezembro de 2016 16:16
Para: André de Oliveira Ruz <andre.ruz@mstech.com.br>
Cc: Thiago Favarin Froes <thiago.froes@mstech.com.br>
Assunto: Re: Re: Bluemonitor - Relatórios de uso de aplicações (btracker)

Apenas para deixar claro que configurar o elastic apenas com o comando do PUT do email, vai dar erro.

Bruno Fernandes Casella
Desenvolvimento
Diretoria de Operações

Tel. (14) 3235-5500 - Ramal 5590
mstech [ www.mstech.com.br ]
Antes de imprimir, pense em sua

responsabilidade com o meio ambiente

2016-12-27 12:17 GMT-02:00 André de Oliveira Ruz <andre.ruz@mstech.com.br>:

-------- Mensagem original --------

Assunto:

Re: Bluemonitor - Relatórios de uso de aplicações (btracker)

Data:

05/12/2016 12:36

De:

Antonio Filho <antonio.filho@mstech.com.br>

Para:

Arnaldo Gerner Rosa <arnaldo.gerner@mstech.com.br>, andre.ruz@mstech.com.br

ERRATA: Em MAPEAMENTO ELASTIC SEARCH, favor considere realizar o comando PUT com a URL contendo o índice bluemonitor, caso bluemonitor tenha sido o nome do índice escolhido. Exemplo: http://192.168.44.3:9200/bluemonitor

Em 05/12/2016 11:21, Antonio Filho escreveu:

Olá, bom dia.

Gerei a #38 e última versão do BlueMonitorSSO-Dev, versão 5.5.10.2. Publiquei esta versão no TS-IIS03. Para o pacote dessa nova versão faz-se necessário alterar o Web.config do Bluemonitor e mapear o índice e tipo utilizados no Elastic Search, assim como dizem as linhas abaixo.

WEB.CONFIG

No Web.config do Bluemonitor é necessário incluir a chave "urlElasticSearchBTracker" dentro da tag appSettings, e o valor dela deve ser a URL completa do servidor do Elastic Search, apontando para o índice utilizado pelo BTracker, e com o protocolo. Se o índice utilizado no Elastic Search se chama bluemonitor, e o serviço está em http://192.168.44.3:9200, a URL seria: http://192.168.44.3:9200/bluemonitor

<appSettings>
<add key="urlElasticSearchBTracker" value="http://192.168.44.3:9200/bluemonitor"/>
</appSettings>

MAPEAMENTO ELASTIC SEARCH

Quando o serviço do Elastic Search estiver respondendo por um IP e porta, por exemplo http://192.168.44.3:9200, se o índice escolhido se chamar bluemonitor e o tipo do documento btracker_app, então execute um comando PUT para a URL http://192.168.44.3:9200 com o JSON abaixo para mapear os dados e possibilitar a utilização dos "relatórios do btracker" no Bluemonitor.

PUT http://192.168.44.3:9200
{
"mappings": {
"btracker_app": {
"properties": {
"diretoriaID": {
"type": "keyword",
"index": "not_analyzed"
},
"schoolID": {
"type": "keyword",
"index": "not_analyzed"
},
"userType": {
"type": "keyword",
"index": "not_analyzed"
},
"timeSpent": {
"type": "keyword"
}
}
}
}
}

--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

Abaixo estão algumas observações e notas que considero importantes e/o necessárias.

TESTES

Acredito que mais testes com volumes diferentes de dados deveriam ter sido executados, porém como o tempo não permitiu, a Halana e eu focamos em testar os relatórios com uma massa de dados que permitisse a análise e constatasse a precisão dos cálculos para o resultado esperado nos modelos propostos pelo requisito.

PERFORMANCE DO ELASTIC SEARCH

Tamanho do documento

Os documentos que estão sendo gerados e salvos no Elastic Search pelo BTracker tem atributos iguais aos que estão abaixo.

{
"userName": "marriely.garcia",
"peopleName": "",
"processList": null,
"activeWindowName": "chrome",
"activeWindowTitle": "Guia para geração de relatórios de bugs do Youtrack - MSTECH wiki - Google Chrome",
"macAddress": "00:00:00:00:00:00:00:E0 | 78:2B:CB:C3:1E:55 | 00:00:00:00:00:00:00:E0 | 00:15:5D:C4:73:C5 | ",
"finalUseTimeStamp": "2016-11-24T09:15:31Z",
"timeSpent": 1,
"systemOSVersion": "Windows 8.1 6.3",
"schoolID": "30333",
"schoolName": "ESCOLA DA VIDA ",
"schoolNameCode": "30333|||ESCOLA DA VIDA ",
"diretoriaID": "20111",
"diretoriaName": "BONIFACIO",
"userLogin": "Emerson",
"userType": "aluno"
}

Porém, para desenvolver todos os relatórios do BTracker, estou utilizando apenas as propriedades abaixo.

{
"activeWindowName": "chrome",
"timeSpent": 1,
"schoolID": "30333",
"diretoriaID": "20111",
"userType": "aluno"
}

O propósito de cada atributo é:

"activeWindowName" = Identificar a aplicação que foi utilizada
"timeSpent" = Contabilizar o tempo de utilização da aplicação em minutos
"schoolID" = Identificar a escola pertencente a uma diretoria
"diretoriaID": Identificar a diretoria de uma escola
"userType": Identificar o tipo de usuário que utilizou a aplicação

Aconselho não salvar o restante do documento que não está sendo utilizado desde que não tenham planos de consultá-los mais tarde, para outros propósitos ou mesmo em relatórios, preferencialmente associados aos atributos que utilizei. O motivo é que não se preocupar com isso é um erro, visto que a indexação do Elastic Search pode consumir o disco rígido e memória RAM de maneira inapropriada, dependendo do volume de dados que armazena e utiliza, principalmente em operações de agregação e ordenação - que estão sendo utilizados nos relatórios do BTracker - e também pela falta de tempo em analisar se o Elastic Search está configurado adequadamente para a nossa necessidade de uso, como explica um pouco o próprio blog oficial da ferramenta: https://www.elastic.co/blog/elasticsearch-storage-the-true-story

Atualização automática de dados

Caso necessário mais tarde fazer com que o relatório seja atualizado automaticamente, definindo uma periodicidade de atualização, causando a sensação de que está trabalhando e exibindo dados em tempo real, o VueJS foi utilizado para agilizar o bind de dados na view, principalmente se forem desenvolvidos campos de pesquisa, filtros ou botões de ordenação, e comandos da api de pesquisa (_search) do Elastic Search estão sendo utilizados para diminuir o tráfego de dados na rede, e custo de processamento de dados no servidor do Bluemonitor e browser do cliente; o que não precisa ser mudado caso não seja necessário atualizar os dados periodicamente. Porém, para agilizar a abertura dos relatórios, faz-se necessário melhorar a consulta de dados ou mudar a estratégia de armazenamento de diretorias e escolas do Bluemonitor, pois os dados são cacheados após a primeira consulta, sempre que o usuário acessa o relatório pela primeira vez, após autenticar-se no sistema, mas o primeiro acesso é sempre muito lento.

Quaisquer dúvidas sobre como realizar os procedimentos acima, estou à disposição.

Att,
Antônio Marcos

== Comandos Python (DarthFaker) ==
App para gerar uma massa de dados em um índice pré-existente no server elastic.

=== Instalação ===
- baixar o Python v 2.7.13: https://www.python.org/ftp/python/2.7.13/python-2.7.13.msi
- instalar

=== Compilando ===

Abrir o gitbash, ir na raiz da aplicação onde tem o arquivo __init__.py (exemplo)

ruz@MS-N2437 MINGW64 /c/Documents and Settings/ruz/Documents/Ruz/MSTECH/BlueMonitorapi/Inventario/elasticsearch/elasticsearch

, e digitar:

python __init__.py

caso venha a mensagem de erro de que não foi possível encontrar o nome 'python', talvez foi por causa da instalação, em que ele não ficou como variável de ambiente, então digite:

/c/Python27/python.exe __init__.py

=== Importando módulos externos ===

Caso dê erro de importação, é necessário importar o módulo. Ex:

Erro:
Traceback (most recent call last):
File "__init__.py", line 5, in <module>
from darthfaker import Faker

Executar o instalador de módulos externos do Python, o "easy_install.exe":

/c/Python27/Scripts/easy_install.exe elasticsearch

até acabar todos os erros.

=== Busca ===

No git bash, entrar na pasta raiz que será efetuada a busca e entrar:

$ grep -nir activeWindowName *

Neste exemplo, ele busca pelas ocorrências "activeWindowName" em todos os arquivos da pasta corrente e subpastas de onde está sendo executado.

BlueMonitorAPI

2017-11-07T19:16:28Z

Ruz: /* Ambientes */

== CategoriesTree ==

'''[[BMAPI GET api/v1/categoriesTree/(k1Chave)|GET api/v1/categoriesTree/{k1Chave}]]'''
Retorna uma arvore com todas as categorias e unidades administrativas que compõe toda a estrutura de localizações do domínio.

== Devices ==
'''[[BMAPI POST api/v1/devices|POST api/v1/devices]]'''
Cadastra uma máquina no BlueMonitor

== Devices Signals ==
'''[[BMAPI POST api/v1/devices/(k4Chave)/signals|POST api/v1/devices/{k4Chave}/signals]]'''
Registra a atualização do sinal da máquina, indicando que a mesma está ligada

== Devices TurnOff ==
'''[[BMAPI GET api/v1/devices/(k4Chave)/turnoff|GET api/v1/devices/{k4Chave}/turnoff]]'''
Retorna se a máquina deve desligar

'''[[BMAPI POST api/v1/devices/(k4Chave)/turnoff|POST api/v1/devices/{k4Chave}/turnoff]]'''
Registra que a máquina está desligando

== Devices Updates ==
'''[[BMAPI GET api/v1/devices/(k4Chave)/updates|GET api/v1/devices/{k4Chave}/updates]]'''
Retorna os updates associados à máquina

== Devices Updates Status ==
'''[[BMAPI POST api/v1/devices/(k4Chave)/updates/(updateId)/status|POST api/v1/devices/{k4Chave}/updates/{updateId}/status]]'''
Cadastra um novo status de atualização entre um update e uma máquina

'''[[BMAPI PUT api/v1/devices/(k4Chave)/updates/(updateId)/status/(id)|PUT api/v1/devices/{k4Chave}/updates/{updateId}/status/{id}]]'''
Atualiza um status de atualização entre um update e uma máquina

== Devices Types ==
'''[[BMAPI GET api/v1/deviceTypes|GET api/v1/deviceTypes]]'''
Retorna os Tipos de máquinas

== Domains Categories ==
'''[[BMAPI GET api/v1/domains/(k1Chave)/categories|GET api/v1/domains/{k1Chave}/categories]]'''
Retorna as categorias do domínio.

== Domains Categories AdministrativeUnits==
'''[[BMAPI GET api/v1/domains/(k1Chave)/categories/(categoriesId)/administrativeUnit|GET api/v1/domains/{k1Chave}/categories/{categoriesId}/administrativeUnit]]'''
Retorna as Unidades Administrativas que estão associadas à uma categoria do domínio.

== Inventory ==

== Ambientes ==
Configuração: Tabela ''PARAMETRO'' do BlueMonitor
=== Teste (painelAcessa) ===
http://192.168.46.3:9200
'''Btracker:''' /bluemonitorteste/report
'''Inventário software:''' inventorysoftwareteste
'''Inventário hardware:''' inventoryhardwareteste

=== Desenvolvimento ===
http://192.168.46.3:9200
'''Btracker:''' /bluemonitor/report
'''Inventário software:''' inventorysoftware
'''Inventário hardware:''' inventoryhardware

=== Demo ===
http://demo-kibana.mstech.com.br
http://demo-logstash.mstech.com.br
http://demo-elasticsearch.mstech.com.br
'''Btracker:''' /bluemonitordemo/report
'''Inventário software:''' inventorysoftwaredemo
'''Inventário hardware:''' inventoryhardwaredemo

=== Chamadas API ===
'''[[BMAPI POST api/v1/inventoryhardware/|POST api/v1/inventoryhardware/]]'''
Envia um inventário para o ElasticSearch através do BlueMonitor.

'''[[BMAPI POST api/v1/inventorysoftware/|POST api/v1/inventorysoftware/]]'''
Envia um inventário para o ElasticSearch através do BlueMonitor.

Elastic Btracker

2017-11-06T11:40:27Z

Ruz: /* Ambientes */

== Ambientes ==
Configuração: Tabela ''PARAMETRO'' do BlueMonitor
=== Teste (painelAcessa) ===
http://192.168.46.3:9200
'''Btracker:''' /bluemonitorteste/report
'''Inventário software:''' inventorysoftwareteste
'''Inventário hardware:''' inventoryhardwareteste

=== Desenvolvimento ===
http://192.168.46.3:9200
'''Btracker:''' /bluemonitor/report
'''Inventário software:''' inventorysoftware
'''Inventário hardware:''' inventoryhardware

=== Demo ===
http://demo-kibana.mstech.com.br
http://demo-logstash.mstech.com.br
http://demo-elasticsearch.mstech.com.br
'''Btracker:''' /bluemonitordemo/report
'''Inventário software:''' inventorysoftwaredemo
'''Inventário hardware:''' inventoryhardwaredemo

== Aplicativos úteis ==
Sense - Google Chrome
https://chrome.google.com/webstore/detail/sense-beta/lhjgkmllcaadmopgmanpapmpjgmfcfig

Plugin client rest, parecido com o PostMan, facilita as queries para o elasticSearch

== Criando mapeamento (estrutura do índice) ==
Criando o índice chamado "bluemonitor", e o mapeamento chamado "report":

no Sense:

URL: http://192.168.46.12:9200
Body:

PUT bluemonitor
{
"aliases": {},
"mappings": {
"report": {
"properties": {
"activeWindowName": {
"type": "keyword"
},
"activeWindowTitle": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"diretoriaID": {
"type": "keyword"
},
"diretoriaName": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"finalUseTimeStamp": {
"type": "date"
},
"macAddress": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"peopleName": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"processList": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"schoolID": {
"type": "keyword"
},
"schoolName": {
"type": "keyword"
},
"systemOSVersion": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"timeSpent": {
"type": "long"
},
"userName": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"userType": {
"type": "keyword"
}
}
}
}
}

== Gravando um documento no formato Btracker no Elastic ==
Server (url): http://192.168.46.12:9200/

Body:

POST /bluemonitor/report
{
"userName": "marriely.garcia",
"peopleName": "",
"processList": null,
"activeWindowName": "chrome",
"activeWindowTitle": "Guia para geração de relatórios de bugs do Youtrack - MSTECH wiki - Google Chrome",
"macAddress": "00:00:00:00:00:00:00:E0 | 78:2B:CB:C3:1E:55 | 00:00:00:00:00:00:00:E0 | 00:15:5D:C4:73:C5 | ",
"finalUseTimeStamp": "2016-11-24T09:15:31Z",
"timeSpent": 1,
"systemOSVersion": "Windows 8.1 6.3",
"schoolID": "30333",
"schoolName": "ESCOLA DA VIDA ",
"schoolNameCode": "30333|||ESCOLA DA VIDA ",
"diretoriaID": "20111",
"diretoriaName": "BONIFACIO",
"userLogin": "Emerson",
"userType": "aluno"

}

== Apagando todos os documentos do mapeamento ==
Server (url): http://192.168.46.12:9200
body:

DELETE bluemonitor

== Listando registros (GET) ==
* no browser: http://192.168.46.3:9200/bluemonitor/report/_search
* no Sense:
(o sense considera os espaços e quebras de linha, caso tenha algo errado, ele não dá o comando)

GET bluemonitor/report/_search
{
"query": { "match_all": {} }
}

== Correção Erros ==
Caso o serviço não esteja iniciando, verificar primeiro:
1 - services.msc -> Serviço Elastic está iniciado?

1a - Se iniciar, atualize a tela do services.msc algumas vezes com o F5, se ele parar de rodar, é porque pode estar com incompatibilidade de IPs.

2 - Abrir o arquivo "elasticsearch.yml" NO WORDPAD (NÃO USAR NOTEPAD) em Elastic\config, vá para a última linha, verifique o IP, e se o mesmo pode ser usado. é o IP de saída, por onde as outras máquinas vão acessar o server elastic.

3 - Ir nas configurações de rede: Painel de Controle\Rede e Internet\Conexões de Rede
localize a rede ativa atual, botão direito -> Propriedades -> Protocolo TCP/IP Versão 4 (TCP/IPv4) -> Propriedades.

4 - Marcar: "usar o seguinte endereço de IP";
a - Endereço IP: (o mesmo do elasticsearch.yml): ex: 192.168.46.12
b - Máscara de sub-rede: 255.255.255.0
c - 192.168.46.1
d - Usar os seguintes endereços de servidor DNS -> servidor dns preferencial: 192.168.250.1

Caso não funcione, ou você não saiba o IP correto de saída, consulte o GTI.

== Introdução (Histórico e-mails) ==

Em 8 de fevereiro de 2017 13:36, Thiago Froes <thiago.froes@mstech.com.br> escreveu:
Olá Casella, tudo bem?

Segue abaixo a estrutura do índice que criamos nos ambiente de homologação e produção que obtiveram sucesso na execução dos relatórios:

/*******************************************************************************/
Criar Indice
/*******************************************************************************/

PUT bluemonitor
{
"aliases": {},
"mappings": {
"report": {
"properties": {
"activeWindowName": {
"type": "keyword"
},
"activeWindowTitle": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"diretoriaID": {
"type": "keyword"
},
"diretoriaName": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"finalUseTimeStamp": {
"type": "date"
},
"macAddress": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"peopleName": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"processList": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"schoolID": {
"type": "keyword"
},
"schoolName": {
"type": "keyword"
},
"systemOSVersion": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"timeSpent": {
"type": "long"
},
"userName": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"userType": {
"type": "keyword"
}
}
}
}
}

Obrigado

2016-12-27 17:50 GMT-02:00 André Ruz <andre.ruz@mstech.com.br>:
Depois que o Casella enviou pra mim o commando put que o btracker gera, suportando também o json que o Antônio enviou no e-mail abaixo:

PUT: http://10.17.15.150:9200/bluemonitor

{
"mappings":{
"report":{
"properties":{
"finalUseTimeStamp":{
"format":"dateOptionalTime",
"type":"date"
},
"processList":{
"index":"not_analyzed",
"type":"string"
},
"timeSpent":{
"type":"keyword"
},
"peopleName":{
"index":"not_analyzed",
"type":"string"
},
"systemOSVersion":{
"index":"not_analyzed",
"type":"string"
},
"diretoriaID":{
"index":"not_analyzed",
"type":"keyword"
},
"userName":{
"index":"not_analyzed",
"type":"string"
},
"schoolNameCode":{
"index":"not_analyzed",
"type":"string"
},
"activeWindowName":{
"index":"not_analyzed",
"type":"string"
},
"activeWindowTitle":{
"index":"not_analyzed",
"type":"string"
},
"userLogin":{
"index":"not_analyzed",
"type":"string"
},
"macAddress":{
"index":"not_analyzed",
"type":"string"
},
"diretoriaName":{
"index":"not_analyzed",
"type":"string"
},
"schoolID":{
"index":"not_analyzed",
"type":"keyword"
},
"userType":{
"index":"not_analyzed",
"type":"keyword"
},
"schoolName":{
"index":"not_analyzed",
"type":"string"
}
}
}
}
}

A configuração ocorreu com sucesso. Ainda temos pendente de um problema com um dos filtros que no nosso ambiente de backup funciona, mas na homologação ainda não deu certo. Fora isso, o retorno aparentemente mostrado na página foi realizado com sucesso.

André Ruz

Estratégias Tecnológicas

Cel. +55 14 98809-8569
Tel. +55 14 3235-5500
mstech [ www.mstech.com.br ]

Antes de imprimir, pense em sua
responsabilidade com o meio ambiente

De: Bruno Fernandes Casella [mailto:bruno.casella@mstech.com.br]
Enviada em: terça-feira, 27 de dezembro de 2016 16:16
Para: André de Oliveira Ruz <andre.ruz@mstech.com.br>
Cc: Thiago Favarin Froes <thiago.froes@mstech.com.br>
Assunto: Re: Re: Bluemonitor - Relatórios de uso de aplicações (btracker)

Apenas para deixar claro que configurar o elastic apenas com o comando do PUT do email, vai dar erro.

Bruno Fernandes Casella
Desenvolvimento
Diretoria de Operações

Tel. (14) 3235-5500 - Ramal 5590
mstech [ www.mstech.com.br ]
Antes de imprimir, pense em sua

responsabilidade com o meio ambiente

2016-12-27 12:17 GMT-02:00 André de Oliveira Ruz <andre.ruz@mstech.com.br>:

-------- Mensagem original --------

Assunto:

Re: Bluemonitor - Relatórios de uso de aplicações (btracker)

Data:

05/12/2016 12:36

De:

Antonio Filho <antonio.filho@mstech.com.br>

Para:

Arnaldo Gerner Rosa <arnaldo.gerner@mstech.com.br>, andre.ruz@mstech.com.br

ERRATA: Em MAPEAMENTO ELASTIC SEARCH, favor considere realizar o comando PUT com a URL contendo o índice bluemonitor, caso bluemonitor tenha sido o nome do índice escolhido. Exemplo: http://192.168.44.3:9200/bluemonitor

Em 05/12/2016 11:21, Antonio Filho escreveu:

Olá, bom dia.

Gerei a #38 e última versão do BlueMonitorSSO-Dev, versão 5.5.10.2. Publiquei esta versão no TS-IIS03. Para o pacote dessa nova versão faz-se necessário alterar o Web.config do Bluemonitor e mapear o índice e tipo utilizados no Elastic Search, assim como dizem as linhas abaixo.

WEB.CONFIG

No Web.config do Bluemonitor é necessário incluir a chave "urlElasticSearchBTracker" dentro da tag appSettings, e o valor dela deve ser a URL completa do servidor do Elastic Search, apontando para o índice utilizado pelo BTracker, e com o protocolo. Se o índice utilizado no Elastic Search se chama bluemonitor, e o serviço está em http://192.168.44.3:9200, a URL seria: http://192.168.44.3:9200/bluemonitor

<appSettings>
<add key="urlElasticSearchBTracker" value="http://192.168.44.3:9200/bluemonitor"/>
</appSettings>

MAPEAMENTO ELASTIC SEARCH

Quando o serviço do Elastic Search estiver respondendo por um IP e porta, por exemplo http://192.168.44.3:9200, se o índice escolhido se chamar bluemonitor e o tipo do documento btracker_app, então execute um comando PUT para a URL http://192.168.44.3:9200 com o JSON abaixo para mapear os dados e possibilitar a utilização dos "relatórios do btracker" no Bluemonitor.

PUT http://192.168.44.3:9200
{
"mappings": {
"btracker_app": {
"properties": {
"diretoriaID": {
"type": "keyword",
"index": "not_analyzed"
},
"schoolID": {
"type": "keyword",
"index": "not_analyzed"
},
"userType": {
"type": "keyword",
"index": "not_analyzed"
},
"timeSpent": {
"type": "keyword"
}
}
}
}
}

--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

Abaixo estão algumas observações e notas que considero importantes e/o necessárias.

TESTES

Acredito que mais testes com volumes diferentes de dados deveriam ter sido executados, porém como o tempo não permitiu, a Halana e eu focamos em testar os relatórios com uma massa de dados que permitisse a análise e constatasse a precisão dos cálculos para o resultado esperado nos modelos propostos pelo requisito.

PERFORMANCE DO ELASTIC SEARCH

Tamanho do documento

Os documentos que estão sendo gerados e salvos no Elastic Search pelo BTracker tem atributos iguais aos que estão abaixo.

{
"userName": "marriely.garcia",
"peopleName": "",
"processList": null,
"activeWindowName": "chrome",
"activeWindowTitle": "Guia para geração de relatórios de bugs do Youtrack - MSTECH wiki - Google Chrome",
"macAddress": "00:00:00:00:00:00:00:E0 | 78:2B:CB:C3:1E:55 | 00:00:00:00:00:00:00:E0 | 00:15:5D:C4:73:C5 | ",
"finalUseTimeStamp": "2016-11-24T09:15:31Z",
"timeSpent": 1,
"systemOSVersion": "Windows 8.1 6.3",
"schoolID": "30333",
"schoolName": "ESCOLA DA VIDA ",
"schoolNameCode": "30333|||ESCOLA DA VIDA ",
"diretoriaID": "20111",
"diretoriaName": "BONIFACIO",
"userLogin": "Emerson",
"userType": "aluno"
}

Porém, para desenvolver todos os relatórios do BTracker, estou utilizando apenas as propriedades abaixo.

{
"activeWindowName": "chrome",
"timeSpent": 1,
"schoolID": "30333",
"diretoriaID": "20111",
"userType": "aluno"
}

O propósito de cada atributo é:

"activeWindowName" = Identificar a aplicação que foi utilizada
"timeSpent" = Contabilizar o tempo de utilização da aplicação em minutos
"schoolID" = Identificar a escola pertencente a uma diretoria
"diretoriaID": Identificar a diretoria de uma escola
"userType": Identificar o tipo de usuário que utilizou a aplicação

Aconselho não salvar o restante do documento que não está sendo utilizado desde que não tenham planos de consultá-los mais tarde, para outros propósitos ou mesmo em relatórios, preferencialmente associados aos atributos que utilizei. O motivo é que não se preocupar com isso é um erro, visto que a indexação do Elastic Search pode consumir o disco rígido e memória RAM de maneira inapropriada, dependendo do volume de dados que armazena e utiliza, principalmente em operações de agregação e ordenação - que estão sendo utilizados nos relatórios do BTracker - e também pela falta de tempo em analisar se o Elastic Search está configurado adequadamente para a nossa necessidade de uso, como explica um pouco o próprio blog oficial da ferramenta: https://www.elastic.co/blog/elasticsearch-storage-the-true-story

Atualização automática de dados

Caso necessário mais tarde fazer com que o relatório seja atualizado automaticamente, definindo uma periodicidade de atualização, causando a sensação de que está trabalhando e exibindo dados em tempo real, o VueJS foi utilizado para agilizar o bind de dados na view, principalmente se forem desenvolvidos campos de pesquisa, filtros ou botões de ordenação, e comandos da api de pesquisa (_search) do Elastic Search estão sendo utilizados para diminuir o tráfego de dados na rede, e custo de processamento de dados no servidor do Bluemonitor e browser do cliente; o que não precisa ser mudado caso não seja necessário atualizar os dados periodicamente. Porém, para agilizar a abertura dos relatórios, faz-se necessário melhorar a consulta de dados ou mudar a estratégia de armazenamento de diretorias e escolas do Bluemonitor, pois os dados são cacheados após a primeira consulta, sempre que o usuário acessa o relatório pela primeira vez, após autenticar-se no sistema, mas o primeiro acesso é sempre muito lento.

Quaisquer dúvidas sobre como realizar os procedimentos acima, estou à disposição.

Att,
Antônio Marcos

== Comandos Python (DarthFaker) ==
App para gerar uma massa de dados em um índice pré-existente no server elastic.

=== Instalação ===
- baixar o Python v 2.7.13: https://www.python.org/ftp/python/2.7.13/python-2.7.13.msi
- instalar

=== Compilando ===

Abrir o gitbash, ir na raiz da aplicação onde tem o arquivo __init__.py (exemplo)

ruz@MS-N2437 MINGW64 /c/Documents and Settings/ruz/Documents/Ruz/MSTECH/BlueMonitorapi/Inventario/elasticsearch/elasticsearch

, e digitar:

python __init__.py

caso venha a mensagem de erro de que não foi possível encontrar o nome 'python', talvez foi por causa da instalação, em que ele não ficou como variável de ambiente, então digite:

/c/Python27/python.exe __init__.py

=== Importando módulos externos ===

Caso dê erro de importação, é necessário importar o módulo. Ex:

Erro:
Traceback (most recent call last):
File "__init__.py", line 5, in <module>
from darthfaker import Faker

Executar o instalador de módulos externos do Python, o "easy_install.exe":

/c/Python27/Scripts/easy_install.exe elasticsearch

até acabar todos os erros.

=== Busca ===

No git bash, entrar na pasta raiz que será efetuada a busca e entrar:

$ grep -nir activeWindowName *

Neste exemplo, ele busca pelas ocorrências "activeWindowName" em todos os arquivos da pasta corrente e subpastas de onde está sendo executado.

Anotações Git

2017-10-26T11:51:41Z

Ruz: /* Entregando em produção */

== Urls ==
* http://gitlab.mstech.com.br
* https://git-scm.com
* http://gitignore.io
* https://www.sourcetreeapp.com/

== git bash ==
operações com diretório:
pwd: lista local atual
cd /: volta pra raiz
cd c/projetos/git

== Configurações iniciais ==

=== pegar uma chave ssh: ===
<gitlab dá um comando> <br />
ssh-keygen -t rsa -C "andre.ruz@mstech.com.br" <br />

=== cat: lista uma chave gerada pelo git: ===
$ cat /c/Users/ruz/.ssh/id_rsa.pub

=== baixar solução: git clone ===
$ git clone git@gitlab.mstech.com.br:diarioclasse/diarioclasse.git (baixa a master)

=== Adicionar submódulos (dependências) ===
(entra na pasta raiz do projeto que tenha submódulo)
$git submodule init

$git submodule update

ls: lista os diretórios da pasta corrente

=== alterar para dev (branch): ===
$ git checkout dev

a partir disso, o branch corrente já fica selecionado como o dev.

=== Comandos básicos ===
==== git status: ====
mostra o que tem pendente na pasta
==== cd dcs-gestao: ====
entra na pasta dcs-gestao
==== ls: lista o que tem na pasta ====
==== git checkout -b dev: ====
troca a pasta de checkout para dev, como ativa.
==== git add src: ====
sobe tudo para um espaço intermediário (staged)
==== git commit: ====
* tem que escrever um texto de resumo básico, depois dá enter 2x, escreve uma observação mais detalhada.
* apertar Esc, depois ":wq"
==== git push: ====
mandar para o servidor

* Chave SSH fica nesta pasta: %HOMEDRIVE%%HOMEPATH%\.ssh

== gitIgnore ==
* http://gitignore.io

* 1 - criar um arquivo (de nome ".gitignore):
* 2 - vim .gitignore
* 3 - escreva o corpo do texto, depois esc, :wq pra sair

== remover pasta (recursiva): ==
git rm -f -r src/ModeloDDD.MVC/bin

== remover branch local: ==
$ git branch -d branch_name

== SourceTree ==
* Ferramentas - Criar ou importar chave SSH.
* Arquivo -> Abrir -> pegar a pasta local da máquina onde está localizado o repositório de dados.

== GitFlow ==

=== Início ===
Depois de criar a master, e dar push

http://danielkummer.github.io/git-flow-cheatsheet/index.pt_BR.html

iniciando com '''git flow init''', preenche com os padrões sugeridos por ele mesmo

=== Fluxo desenvolvimento ===
==== Desenvolvendo ====
* 1 - (develop) git flow feature start MYFEATURE
<faz as coisas>
* 2 - (feature) git add . (tem que acrescentar o ponto no final)
* 3 - (feature) git commit
* 3.1 - Aperte "A" na primeira linha.
Tem que escrever um texto de resumo básico, depois dá enter 2x, escreve uma observação mais detalhada.
apertar Esc, depois ":wq"
* 4 - (feature) git checkout develop
* 5 - (develop) git pull
* 6 - (develop) git checkout feature/MYFEATURE
* 7 - (feature) git merge develop
* 8 - <resolva o merge na feature>
* 9 - (feature) git flow feature finish MYFEATURE
* 10 - (develop) git push

==== Publicando para testes ====
* 11 - (develop) git flow release start 1.0.0
* 12 - <publica em testes, vê se deu certo, nome do release pode ser qquer coisa>
* 13 - (release) git add . (tem que acrescentar o ponto no final)
* 14 - (release) git commit
* 15 - (release) git flow release finish 1.0.0
* 16 - (develop) git push

==== Entregando em produção ====
* 17 - (develop) git checkout master
* 18 - (master) git push
* 19 - (master) git push --tag
* 20 - (master) git checkout develop

Anotações Git

2017-10-25T19:41:14Z

Ruz: /* Entregando em produção */

Elastic Btracker

2017-10-13T19:22:54Z

Ruz:

== Ambientes ==
Configuração: Tabela ''PARAMETRO'' do BlueMonitor
=== Teste (painelAcessa) ===
http://192.168.46.3:9200
'''Btracker:''' /bluemonitorteste/report
'''Inventário software:''' inventorysoftwareteste
'''Inventário hardware:''' inventoryhardwareteste

=== Desenvolvimento ===
http://192.168.46.3:9200
'''Btracker:''' /bluemonitor/report
'''Inventário software:''' inventorysoftware
'''Inventário hardware:''' inventoryhardware

== Aplicativos úteis ==
Sense - Google Chrome
https://chrome.google.com/webstore/detail/sense-beta/lhjgkmllcaadmopgmanpapmpjgmfcfig

Plugin client rest, parecido com o PostMan, facilita as queries para o elasticSearch

== Criando mapeamento (estrutura do índice) ==
Criando o índice chamado "bluemonitor", e o mapeamento chamado "report":

no Sense:

URL: http://192.168.46.12:9200
Body:

PUT bluemonitor
{
"aliases": {},
"mappings": {
"report": {
"properties": {
"activeWindowName": {
"type": "keyword"
},
"activeWindowTitle": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"diretoriaID": {
"type": "keyword"
},
"diretoriaName": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"finalUseTimeStamp": {
"type": "date"
},
"macAddress": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"peopleName": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"processList": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"schoolID": {
"type": "keyword"
},
"schoolName": {
"type": "keyword"
},
"systemOSVersion": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"timeSpent": {
"type": "long"
},
"userName": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"userType": {
"type": "keyword"
}
}
}
}
}

== Gravando um documento no formato Btracker no Elastic ==
Server (url): http://192.168.46.12:9200/

Body:

POST /bluemonitor/report
{
"userName": "marriely.garcia",
"peopleName": "",
"processList": null,
"activeWindowName": "chrome",
"activeWindowTitle": "Guia para geração de relatórios de bugs do Youtrack - MSTECH wiki - Google Chrome",
"macAddress": "00:00:00:00:00:00:00:E0 | 78:2B:CB:C3:1E:55 | 00:00:00:00:00:00:00:E0 | 00:15:5D:C4:73:C5 | ",
"finalUseTimeStamp": "2016-11-24T09:15:31Z",
"timeSpent": 1,
"systemOSVersion": "Windows 8.1 6.3",
"schoolID": "30333",
"schoolName": "ESCOLA DA VIDA ",
"schoolNameCode": "30333|||ESCOLA DA VIDA ",
"diretoriaID": "20111",
"diretoriaName": "BONIFACIO",
"userLogin": "Emerson",
"userType": "aluno"

}

== Apagando todos os documentos do mapeamento ==
Server (url): http://192.168.46.12:9200
body:

DELETE bluemonitor

== Listando registros (GET) ==
* no browser: http://192.168.46.3:9200/bluemonitor/report/_search
* no Sense:
(o sense considera os espaços e quebras de linha, caso tenha algo errado, ele não dá o comando)

GET bluemonitor/report/_search
{
"query": { "match_all": {} }
}

== Correção Erros ==
Caso o serviço não esteja iniciando, verificar primeiro:
1 - services.msc -> Serviço Elastic está iniciado?

1a - Se iniciar, atualize a tela do services.msc algumas vezes com o F5, se ele parar de rodar, é porque pode estar com incompatibilidade de IPs.

2 - Abrir o arquivo "elasticsearch.yml" NO WORDPAD (NÃO USAR NOTEPAD) em Elastic\config, vá para a última linha, verifique o IP, e se o mesmo pode ser usado. é o IP de saída, por onde as outras máquinas vão acessar o server elastic.

3 - Ir nas configurações de rede: Painel de Controle\Rede e Internet\Conexões de Rede
localize a rede ativa atual, botão direito -> Propriedades -> Protocolo TCP/IP Versão 4 (TCP/IPv4) -> Propriedades.

4 - Marcar: "usar o seguinte endereço de IP";
a - Endereço IP: (o mesmo do elasticsearch.yml): ex: 192.168.46.12
b - Máscara de sub-rede: 255.255.255.0
c - 192.168.46.1
d - Usar os seguintes endereços de servidor DNS -> servidor dns preferencial: 192.168.250.1

Caso não funcione, ou você não saiba o IP correto de saída, consulte o GTI.

== Introdução (Histórico e-mails) ==

Em 8 de fevereiro de 2017 13:36, Thiago Froes <thiago.froes@mstech.com.br> escreveu:
Olá Casella, tudo bem?

Segue abaixo a estrutura do índice que criamos nos ambiente de homologação e produção que obtiveram sucesso na execução dos relatórios:

/*******************************************************************************/
Criar Indice
/*******************************************************************************/

PUT bluemonitor
{
"aliases": {},
"mappings": {
"report": {
"properties": {
"activeWindowName": {
"type": "keyword"
},
"activeWindowTitle": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"diretoriaID": {
"type": "keyword"
},
"diretoriaName": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"finalUseTimeStamp": {
"type": "date"
},
"macAddress": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"peopleName": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"processList": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"schoolID": {
"type": "keyword"
},
"schoolName": {
"type": "keyword"
},
"systemOSVersion": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"timeSpent": {
"type": "long"
},
"userName": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"userType": {
"type": "keyword"
}
}
}
}
}

Obrigado

2016-12-27 17:50 GMT-02:00 André Ruz <andre.ruz@mstech.com.br>:
Depois que o Casella enviou pra mim o commando put que o btracker gera, suportando também o json que o Antônio enviou no e-mail abaixo:

PUT: http://10.17.15.150:9200/bluemonitor

{
"mappings":{
"report":{
"properties":{
"finalUseTimeStamp":{
"format":"dateOptionalTime",
"type":"date"
},
"processList":{
"index":"not_analyzed",
"type":"string"
},
"timeSpent":{
"type":"keyword"
},
"peopleName":{
"index":"not_analyzed",
"type":"string"
},
"systemOSVersion":{
"index":"not_analyzed",
"type":"string"
},
"diretoriaID":{
"index":"not_analyzed",
"type":"keyword"
},
"userName":{
"index":"not_analyzed",
"type":"string"
},
"schoolNameCode":{
"index":"not_analyzed",
"type":"string"
},
"activeWindowName":{
"index":"not_analyzed",
"type":"string"
},
"activeWindowTitle":{
"index":"not_analyzed",
"type":"string"
},
"userLogin":{
"index":"not_analyzed",
"type":"string"
},
"macAddress":{
"index":"not_analyzed",
"type":"string"
},
"diretoriaName":{
"index":"not_analyzed",
"type":"string"
},
"schoolID":{
"index":"not_analyzed",
"type":"keyword"
},
"userType":{
"index":"not_analyzed",
"type":"keyword"
},
"schoolName":{
"index":"not_analyzed",
"type":"string"
}
}
}
}
}

A configuração ocorreu com sucesso. Ainda temos pendente de um problema com um dos filtros que no nosso ambiente de backup funciona, mas na homologação ainda não deu certo. Fora isso, o retorno aparentemente mostrado na página foi realizado com sucesso.

André Ruz

Estratégias Tecnológicas

Cel. +55 14 98809-8569
Tel. +55 14 3235-5500
mstech [ www.mstech.com.br ]

Antes de imprimir, pense em sua
responsabilidade com o meio ambiente

De: Bruno Fernandes Casella [mailto:bruno.casella@mstech.com.br]
Enviada em: terça-feira, 27 de dezembro de 2016 16:16
Para: André de Oliveira Ruz <andre.ruz@mstech.com.br>
Cc: Thiago Favarin Froes <thiago.froes@mstech.com.br>
Assunto: Re: Re: Bluemonitor - Relatórios de uso de aplicações (btracker)

Apenas para deixar claro que configurar o elastic apenas com o comando do PUT do email, vai dar erro.

Bruno Fernandes Casella
Desenvolvimento
Diretoria de Operações

Tel. (14) 3235-5500 - Ramal 5590
mstech [ www.mstech.com.br ]
Antes de imprimir, pense em sua

responsabilidade com o meio ambiente

2016-12-27 12:17 GMT-02:00 André de Oliveira Ruz <andre.ruz@mstech.com.br>:

-------- Mensagem original --------

Assunto:

Re: Bluemonitor - Relatórios de uso de aplicações (btracker)

Data:

05/12/2016 12:36

De:

Antonio Filho <antonio.filho@mstech.com.br>

Para:

Arnaldo Gerner Rosa <arnaldo.gerner@mstech.com.br>, andre.ruz@mstech.com.br

ERRATA: Em MAPEAMENTO ELASTIC SEARCH, favor considere realizar o comando PUT com a URL contendo o índice bluemonitor, caso bluemonitor tenha sido o nome do índice escolhido. Exemplo: http://192.168.44.3:9200/bluemonitor

Em 05/12/2016 11:21, Antonio Filho escreveu:

Olá, bom dia.

Gerei a #38 e última versão do BlueMonitorSSO-Dev, versão 5.5.10.2. Publiquei esta versão no TS-IIS03. Para o pacote dessa nova versão faz-se necessário alterar o Web.config do Bluemonitor e mapear o índice e tipo utilizados no Elastic Search, assim como dizem as linhas abaixo.

WEB.CONFIG

No Web.config do Bluemonitor é necessário incluir a chave "urlElasticSearchBTracker" dentro da tag appSettings, e o valor dela deve ser a URL completa do servidor do Elastic Search, apontando para o índice utilizado pelo BTracker, e com o protocolo. Se o índice utilizado no Elastic Search se chama bluemonitor, e o serviço está em http://192.168.44.3:9200, a URL seria: http://192.168.44.3:9200/bluemonitor

<appSettings>
<add key="urlElasticSearchBTracker" value="http://192.168.44.3:9200/bluemonitor"/>
</appSettings>

MAPEAMENTO ELASTIC SEARCH

Quando o serviço do Elastic Search estiver respondendo por um IP e porta, por exemplo http://192.168.44.3:9200, se o índice escolhido se chamar bluemonitor e o tipo do documento btracker_app, então execute um comando PUT para a URL http://192.168.44.3:9200 com o JSON abaixo para mapear os dados e possibilitar a utilização dos "relatórios do btracker" no Bluemonitor.

PUT http://192.168.44.3:9200
{
"mappings": {
"btracker_app": {
"properties": {
"diretoriaID": {
"type": "keyword",
"index": "not_analyzed"
},
"schoolID": {
"type": "keyword",
"index": "not_analyzed"
},
"userType": {
"type": "keyword",
"index": "not_analyzed"
},
"timeSpent": {
"type": "keyword"
}
}
}
}
}

--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

Abaixo estão algumas observações e notas que considero importantes e/o necessárias.

TESTES

Acredito que mais testes com volumes diferentes de dados deveriam ter sido executados, porém como o tempo não permitiu, a Halana e eu focamos em testar os relatórios com uma massa de dados que permitisse a análise e constatasse a precisão dos cálculos para o resultado esperado nos modelos propostos pelo requisito.

PERFORMANCE DO ELASTIC SEARCH

Tamanho do documento

Os documentos que estão sendo gerados e salvos no Elastic Search pelo BTracker tem atributos iguais aos que estão abaixo.

{
"userName": "marriely.garcia",
"peopleName": "",
"processList": null,
"activeWindowName": "chrome",
"activeWindowTitle": "Guia para geração de relatórios de bugs do Youtrack - MSTECH wiki - Google Chrome",
"macAddress": "00:00:00:00:00:00:00:E0 | 78:2B:CB:C3:1E:55 | 00:00:00:00:00:00:00:E0 | 00:15:5D:C4:73:C5 | ",
"finalUseTimeStamp": "2016-11-24T09:15:31Z",
"timeSpent": 1,
"systemOSVersion": "Windows 8.1 6.3",
"schoolID": "30333",
"schoolName": "ESCOLA DA VIDA ",
"schoolNameCode": "30333|||ESCOLA DA VIDA ",
"diretoriaID": "20111",
"diretoriaName": "BONIFACIO",
"userLogin": "Emerson",
"userType": "aluno"
}

Porém, para desenvolver todos os relatórios do BTracker, estou utilizando apenas as propriedades abaixo.

{
"activeWindowName": "chrome",
"timeSpent": 1,
"schoolID": "30333",
"diretoriaID": "20111",
"userType": "aluno"
}

O propósito de cada atributo é:

"activeWindowName" = Identificar a aplicação que foi utilizada
"timeSpent" = Contabilizar o tempo de utilização da aplicação em minutos
"schoolID" = Identificar a escola pertencente a uma diretoria
"diretoriaID": Identificar a diretoria de uma escola
"userType": Identificar o tipo de usuário que utilizou a aplicação

Aconselho não salvar o restante do documento que não está sendo utilizado desde que não tenham planos de consultá-los mais tarde, para outros propósitos ou mesmo em relatórios, preferencialmente associados aos atributos que utilizei. O motivo é que não se preocupar com isso é um erro, visto que a indexação do Elastic Search pode consumir o disco rígido e memória RAM de maneira inapropriada, dependendo do volume de dados que armazena e utiliza, principalmente em operações de agregação e ordenação - que estão sendo utilizados nos relatórios do BTracker - e também pela falta de tempo em analisar se o Elastic Search está configurado adequadamente para a nossa necessidade de uso, como explica um pouco o próprio blog oficial da ferramenta: https://www.elastic.co/blog/elasticsearch-storage-the-true-story

Atualização automática de dados

Caso necessário mais tarde fazer com que o relatório seja atualizado automaticamente, definindo uma periodicidade de atualização, causando a sensação de que está trabalhando e exibindo dados em tempo real, o VueJS foi utilizado para agilizar o bind de dados na view, principalmente se forem desenvolvidos campos de pesquisa, filtros ou botões de ordenação, e comandos da api de pesquisa (_search) do Elastic Search estão sendo utilizados para diminuir o tráfego de dados na rede, e custo de processamento de dados no servidor do Bluemonitor e browser do cliente; o que não precisa ser mudado caso não seja necessário atualizar os dados periodicamente. Porém, para agilizar a abertura dos relatórios, faz-se necessário melhorar a consulta de dados ou mudar a estratégia de armazenamento de diretorias e escolas do Bluemonitor, pois os dados são cacheados após a primeira consulta, sempre que o usuário acessa o relatório pela primeira vez, após autenticar-se no sistema, mas o primeiro acesso é sempre muito lento.

Quaisquer dúvidas sobre como realizar os procedimentos acima, estou à disposição.

Att,
Antônio Marcos

== Comandos Python (DarthFaker) ==
App para gerar uma massa de dados em um índice pré-existente no server elastic.

=== Instalação ===
- baixar o Python v 2.7.13: https://www.python.org/ftp/python/2.7.13/python-2.7.13.msi
- instalar

=== Compilando ===

Abrir o gitbash, ir na raiz da aplicação onde tem o arquivo __init__.py (exemplo)

ruz@MS-N2437 MINGW64 /c/Documents and Settings/ruz/Documents/Ruz/MSTECH/BlueMonitorapi/Inventario/elasticsearch/elasticsearch

, e digitar:

python __init__.py

caso venha a mensagem de erro de que não foi possível encontrar o nome 'python', talvez foi por causa da instalação, em que ele não ficou como variável de ambiente, então digite:

/c/Python27/python.exe __init__.py

=== Importando módulos externos ===

Caso dê erro de importação, é necessário importar o módulo. Ex:

Erro:
Traceback (most recent call last):
File "__init__.py", line 5, in <module>
from darthfaker import Faker

Executar o instalador de módulos externos do Python, o "easy_install.exe":

/c/Python27/Scripts/easy_install.exe elasticsearch

até acabar todos os erros.

=== Busca ===

No git bash, entrar na pasta raiz que será efetuada a busca e entrar:

$ grep -nir activeWindowName *

Neste exemplo, ele busca pelas ocorrências "activeWindowName" em todos os arquivos da pasta corrente e subpastas de onde está sendo executado.

Conta Google Tablets

2017-08-28T16:29:40Z

Ruz: Criou página com 'Devido ao problema na atualização dos aplicativos e algumas pessoas usando contas pessoais e de projetos não pertencentes a mstech, foi criado uma conta padrão google para...'

Devido ao problema na atualização dos aplicativos e algumas pessoas usando contas pessoais e de projetos não pertencentes a mstech, foi criado uma conta padrão google para uso dos tablets mstech:

Login: tabletsMstech@gmail.com
Senha: @dm1n@th

Mentoria de código

2017-08-28T16:28:39Z

Ruz:

* [[Anotações Git]] - Anotações com exemplos básicos de comandos git.
* [[Cursos de programação]] - Cursos online de programação de frentes variadas
* [[Gerar Dicionário de Dados]] - Scripts e ferramentas para gerar dicionário de dados (sql server)
* [[Utilização do GitLab]]
* [[Compare_BD]] - Exemplo de como fazer comparação de schema de bancos de dados
* [[Publicacao]] - Exemplo de como fazer um pacote de publicação e publicar
* [[Migrations]] - Exemplos de comandos básicos de Migrations (Entity Framework)
* [[Infra-inicial-MVC]] - Configuração inicial em uma infra MVC + Entity Framework
* [[Conta Google Tablets]] - Login e senha conta google para tablets MSTECH

Ambientes

2017-08-11T13:13:20Z

Ruz: /* BlueControlWeb */

== Desenvolvimento (Git e TFS) ==
=== BlueMonitor_SSO: ===
https://gitlab.mstech.com.br/bluemonitor/bluemonitorsso.git
(entidade: mstech - Central de Serviços)

BD: dev-sql16\DEV_BlueMonitor_SSO

=== BlueControlWeb ===
$/BlueControlWeb/Main/MSTech.BlueControlWEB-FDE-2008

BD: dev-sql16 -> DEV_BlueControlWeb

$/BlueControlWeb/dev/MSTech.BlueControlWEB-SSO-2008

BD: dev-sql16 -> DEV_BlueControlWeb_SSO

== Testes internos ==
=== FDE ===

http://coressofde2015.devedu.ms/

http://bluemonitorssofde2015.devedu.ms

http://painelacessa.hominterna.fde.devedu.ms/bluemonitorSSO/default.aspx

BD: dev-sql16\pub_FDE_*

=== SMESP ===
CoreSSO: http://192.168.10.22:8100

BlueMonitor: http://192.168.10.22:8101

BD: dev-sql14cli\sme_bkp_*

=== testes (RJ ou Correios): ===
http://192.168.10.22:8001 (CoreSSO)

http://192.168.10.22:8002 (BlueMonitor)

http://192.168.10.22:8003 (Bluemonitor API)[[API]]

BD: ts-bd\RJ_BlueMonitor_SSO

login: admin, senha: 123456

=== Suporte MS ===
http://demonstracao.mstech.com.br
(admin, 123456)

== Demonstração: ==
=== Demonstração geral ===
http://demo.mstech.com.br
(adminbm, 123456)

=== Edital Paraiba ===
http://dpb.mstech.com.br (adminbm, 123456)

== Homologação ==
=== SME ===
http://h-coresso.sme.prefeitura.sp.gov.br/

=== FDE ===
(acesso por VPN)

http://coreblues.educacao.intragov

http://h-acessaescola.fde.sp.gov.br/BlueMonitorSSO

== Produção ==
=== SME ===
http://coresso.sme.prefeitura.sp.gov.br/

=== FDE ===
http://coreblues.educacao.sp.gov.br/

http://www.painelacessa.educacao.sp.gov.br/BlueControlWeb/index.aspx

http://www.painelacessa.educacao.sp.gov.br/BlueMonitorSSO/