The Operations Service

source: https://hyperledger-fabric.readthedocs.io/en/latest/operations_service.html

Configuring the Operation Service

Hyperledger Fabric v1.4부터 업데이트된 Operation Service를 이용하기 위해서는 피어의 접속 정보, TLS 인증서와 개인키 설정이 필요하다.

Peer

Peer Configuration

• config/core.yaml의 'Operations'에서 설정

• ex. operations:

  • listenAddress: 127.0.0.1:9443 // host를 생략하면, 모든All 의미

  • tls: ... // TLS 통신 설정

Orderer

Orderer Configuration

• config/orderer.yaml의 'operations' 에서 설정

• ex. Operations:

  • listenAddress: 127.0.0.1:8443 // host를 생략하면, 모든All 의미

  • tls: ... // TLS 통신 설정

Operations Security

• MSP를 사용하지 않고 client의 TLS 인증서를 기반으로 인증 및 권한 관리

• TLS 설정을 하지 않으면, 모든 client가 해당 API를 사용할 수 있음(인증 과정 X)

• TLS 설정을 하면, 유효한 client 인증서를 제공해야 해당 API를 사용할 수 있음

Log level management

"/logspec" URL을 통해서, REST API로 peer 와 orderer 의 'Log레벨'을 제공한다.

• ex. HTTP "/logspec" GET 요청 -> 응답 {"spec":"info"}

• ex. HTTP "/logspec" PUT {"spec":"chaincode=debug:info"} 요청 -> 응답 {...}

Health Check

"/healthz" URL을 통해서, REST API로 peer 와 orderer 의 접속 상태'를 제공한다. Kubernetes 와 연동이 되도록 설계되었고, 다른곳에 응용해서 사용 가능하다.

• ex. HTTP "/healthz" GET 요청 ->

  • 성공 { "status": "OK", "time": "2009-11-10T23:00:00Z" }

  • 실패 { "status": "Service Unavailable", "time": "2009-11-10T23:00:00Z",

  • "failed_checks": [{ "component": "docker", "reason": "failed ... Docker ... invalid endpoint" }]}

Metrics

peer 및 orderer에 REST API를 이용, "/metrics" 명령을 요청함으로써 데이터를 수집할 수 있다. 운영자나 관리자가 이 metrics정보를 통해서, 시간 경과에 따른 시스템 성능을 가늠하는데 사용할 수 있다.

metrics는 데이터 수집 및 모니터링 Tool로 pull 방식의 prometheus와 push 방식의 statD를 지원한다.

• metrics: https://hyperledger-fabric.readthedocs.io/en/release-1.4/metrics_reference.html