Managing Integrations with apictl¶

WSO2 API Controller, apictl allows you to monitor the Synapse artifacts (deployed in a specified Micro Integrator server) and perform various management and administration tasks from the command line.

Info

Before you begin

Ensure that WSO2 Micro Integrator is started. See the instructions on installing the Micro Integrator.
Make sure the apictl is downloaded and initialized, if not follow the steps in Download and Initialize the apictl.
Ensure that the Micro Integrator management endpoint is added to the environment configurations of CTL, before you start working with the following CTL commands. For more information, see Add an Environment.

After adding an environment, you can login to the Micro Integrator instance of that environment using credentials.

Run any of the following CTL commands to login to a Micro Integrator.
- Command
```
apictl mi login <environment-name> -k
```
```
apictl mi login <environment-name> -u <username> -k
```
```
apictl mi login <environment-name> -u <username> -p <password> -k
```
  Tip
  
  If you run apictl mi login <environment-name> you are prompted to provide both the username and the password. If you run apictl mi login <environment-name> --username <username>, you are prompted to provide the password.
  Info
  
  Flags:
  - Optional :
    --username or -u : Username for login
    --password or -p : Password for login
    --password-stdin : Get password from stdin
  Example
```
apictl mi login dev -k
```
```
apictl mi login dev -u admin -p admin -k
```
```
apictl mi login dev --username admin --password admin -k
```
- Response
  Response FormatExample Response
  Logged into MI in '<environment-name>' environment
  Logged into MI in dev environment
Warning

Using --password in CTL is not secure. You can use --password-stdin instead. For example,
```
cat ~/.mypassword | ./apictl mi login dev --username admin --password-stdin -k
```

Logout from a Micro Integrator¶

Run the following command to logout from the current session of the Micro Integrator.

Command

apictl mi logout <environment-name>

Example

apictl mi logout dev

Response

Response FormatExample Response

Logged out from MI in '<environment-name>' environment

Logged out from MI in dev environment

Manage Users¶

You can view details of users stored in the external user store. If you are logged in to the apictl with administrator credentials, you can also add new users, and remove users from the user store.

Get information about users¶

List users of the Micro Integrator.
- Command
```
apictl mi get users -e <environment>
```
  Info
  
  Flags:
  - Required :
    --environment or -e : Environment of the Micro Integrator to be searched
  - Optional :
    --format : pretty-print using templates
    --pattern or -p : Filter users by regex
    --role or -r : Filter users by role
  Example
```
apictl mi get users -e dev
```
```
apictl mi get users -r admin -e dev
```
```
apictl mi get users -p *tester* -e dev
```
- Response
```
USER ID
admin
capp-tester
```
Get information on a specific user.
- Command
```
apictl mi get users [user-name] -d [domain] -e <environment>
```
  Info
  
  Flags:
  - Required :
    --environment or -e : Environment of the Micro Integrator to be searched
  - Optional :
    --domain or -d : Domain name of the secondary user store to be searched
    --format : pretty-print using templates
  Example
```
apictl mi get users capp-tester -d testing.com -e dev
```
- Response
```
Name - TESTING.COM/capp-tester
Is Admin - false
Roles - TESTING.COM/tester, Application/applicationRole1
```

Add a new user¶

You can use the command below to add a new user to a Micro Integrator.

Command
```
apictl mi add user [user-name] -e <environment>
```
Info

Flags:
- Required :
  --environment or -e : Environment of the Micro Integrator to be searched
Example
```
apictl mi add user capp-tester -e dev
```

Response

Adding new user [ capp-tester ] status: Added

Note

To add a new user to a secondary user store, provide the corresponding user store domain when prompted.

Delete a user¶

You can use the command below to remove a user from the Micro Integrator.

Command
```
apictl mi delete user [user-name] -e <environment>
```
Info

Flags:
- Required :
  --environment or -e : Environment of the Micro Integrator
- Optional :
  --domain or -d : The domain of the secondary user store from which the user should be deleted
Example
```
apictl mi delete user capp-tester -d testing.com -e dev
```

Response

Deleting user [ capp-tester ] status: Deleted

Manage Roles¶

The Micro Integrator has limited role support without fine-grained permission tree support as in the Enterprise Integrator.

In Micro Integrator, we have one admin role and all the other roles from primary and secondary user stores are considered non-admin roles.

Get information about roles¶

List roles of the Micro Integrator.

Command
```
apictl mi get roles -e <environment>
```
Info

Flags:
- Required :
  --environment or -e : Environment of the Micro Integrator to be searched
Example
```
apictl mi get roles -e dev
```

Response

ROLE
admin
primaryRole1
Application/applicationRole1
Internal/everyone
Internal/internalRole1
TEST.COM/testRole1

Get information on a specific role.
- Command
```
apictl mi get roles [role-name] -e <environment>
```
  Info
  
  Flags:
  - Required :
    --environment or -e : Environment of the Micro Integrator to be searched
  - Optional :
    --domain or -d : Domain of the secondary user store to be searched
  Example
```
apictl mi get roles tester -d testing.com -e dev
```
- Response
```
Role Name - TESTING.COM/tester
Users  - TESTING.COM/capp-tester
```

Note

To get hybrid roles (application/internal) specify the role type as the domain.

apictl mi get roles tester -d application -e dev

Add a new role¶

Command

apictl mi add role [role-name] -e <environment>

Info

Flags:

Required :
--environment or -e : Environment of the Micro Integrator

Example

apictl mi add role tester -e dev

Response

Adding new role [ tester ] status: Added

Note

To add a new role to a secondary user store, provide the corresponding user store domain when prompted.

Note

To add hybrid roles (application/internal) specify the type in the role name.

apictl mi add role internal/InternalRole -e dev

Delete a role¶

Command
```
apictl mi delete role [role-name] -e <environment>
```
Info

Flags:
- Required :
  --environment or -e : Environment of the Micro Integrator
- Optional :
  --domain or -d : The domain of the secondary user store from which the role should be deleted
Example
```
apictl mi delete role tester -d testing.com -e dev
```
- Response
```
Deleting new role [ tester ] status: Deleted
```

Note

To delete hybrid roles (application/internal) specify the role type as domain.

apictl mi delete role InternalRole -d internal -e dev

Assign/revoke roles to/from users¶

Command

apictl mi update user [user-name] -e <environment>

Info

Flags:

-   Required :  
    `--environment` or `-e` : Environment of the Micro Integrator

Example

apictl mi update user capp-tester -e dev

Response
```
Added/removed the roles
```

Note

Use a space-separated list of role names when entering the added/removed roles

Monitor Integration Artifacts¶

Follow the instructions below to display a list of artifacts or get information about a specific artifact in an environment using CTL:

Composite Applications (CApps)¶

List composite applications (CApps) in an environment.

Command
```
apictl mi get composite-apps -e <environment>
```
Info

Flags:
- Required :
  --environment or -e : Environment of the Micro Integrator to be searched
- Optional :
  --format : pretty-print using templates
Example
```
apictl mi get composite-apps -e dev
```

Response

NAME                            VERSION
HealthCareCompositeExporter     1.0.0
FoodServiceCApp                 2.0.0

Get information on a specific composite application in an environment.

Command
```
apictl mi get composite-apps [capp-name] -e <environment>
```
Info

Flags:
- Required :
  --environment or -e : Environment of the Micro Integrator to be searched
- Optional :
  --format : pretty-print using templates
Example
```
apictl mi get composite-apps HealthCareCompositeExporter -e dev
```

Response

Name - HealthCareCompositeExporter
Version - 1.0.0
Artifacts :
NAME                      TYPE
sample-local-entry        local-entry
email-connector           lib
in-memory-message-store   message-store
GrandOakEndpoint          endpoint
sample_seq_template       template
scheduled-msg-processor   message-processors
sample_template           template
HealthcareAPI             api
sample-sequence           sequence
PineValleyEndpoint        endpoint
StockQuoteProxy           proxy-service
sample-cron-task          task
httpInboundEP             inbound-endpoint

Integration APIs¶

List integration APIs in an environment.

Command
```
apictl mi get apis -e <environment>
```
Info

Flags:
- Required :
  --environment or -e : Environment of the Micro Integrator to be searched
- Optional :
  --format : pretty-print using templates
Example
```
apictl mi get apis -e dev
```

Response

NAME              URL
HealthcareAPI     http://localhost:8290/healthcare
FoodService       http://localhost:8480/foodservice

Get information on a specific integration API in an environment.

Command
```
apictl mi get apis [api-name] -e <environment>
```
Info

Flags:
- Required :
  --environment or -e : Environment of the Micro Integrator to be searched
- Optional :
  --format : pretty-print using templates
Example
```
apictl mi get apis HealthcareAPI -e dev
```

Response

Name - HealthcareAPI
Version - N/A
Url - http://localhost:8290/healthcare
Stats - disabled
Tracing - disabled
Resources :
URL                    METHOD
/doctor/{doctorType}   [GET]
/report                [GET]

Connectors¶

List connectors in an environment.

Command
```
apictl mi get connectors -e <environment>
```
Info

Flags:
- Required :
  --environment or -e : Environment of the Micro Integrator to be searched
- Optional :
  --format : pretty-print using templates
Example
```
apictl mi get connectors -e dev
```

Response

NAME        STATS         PACKAGE                       DESCRIPTION
email       enabled       org.wso2.carbon.connector     WSO2 email connector library

Data Services¶

List data services in an environment.

Command
```
apictl mi get data-services -e <environment>
```
Info

Flags:
- Required :
  --environment or -e : Environment of the Micro Integrator to be searched
- Optional :
  --format : pretty-print using templates
Example
```
apictl mi get data-services -e dev
```

Response

NAME                WSDL 1.1                                                WSDL 2.0
RESTDataService     http://localhost:8290/services/RESTDataService?wsdl     http://localhost:8290/services/RESTDataService?wsdl2

Get information on a specific data service in an environment.

Command
```
apictl mi get data-services [data-service-name] -e <environment>
```
Info

Flags:
- Required :
  --environment or -e : Environment of the Micro Integrator to be searched
- Optional :
  --format : pretty-print using templates
Example
```
apictl mi get data-services RESTDataService -e dev
```

Response

Name - RESTDataService
Group Name - RESTDataService
Description - Exposing the data service as a REST service.
WSDL 1.1 - http://localhost:8290/services/RESTDataService?wsdl
WSDL 2.0 - http://localhost:8290/services/RESTDataService?wsdl2
Queries :
ID                  NAMESPACE
ReadStudents        http://ws.wso2.org/dataservice/ReadStudents
DeleteStudent       http://ws.wso2.org/dataservice

Endpoints¶

List endpoints in an environment.

Command
```
apictl mi get endpoints -e <environment>
```
Info

Flags:
- Required :
  --environment or -e : Environment of the Micro Integrator to be searched
- Optional :
  --format : pretty-print using templates
Example
```
apictl mi get endpoints -e dev
```

Response

NAME                    TYPE      ACTIVE
GrandOakEndpoint        http      true
PineValleyEndpoint      http      true

Get information on a specific endpoint in an environment.

Command
```
apictl mi get endpoints [endpoint-name] -e <environment>
```
Info

Flags:
- Required :
  --environment or -e : Environment of the Micro Integrator to be searched
- Optional :
  --format : pretty-print using templates
Example
```
apictl mi get endpoints GrandOakEndpoint -e dev
```

Response

Name - GrandOakEndpoint
Type - HTTP Endpoint
Active - true
Method - GET
URI Template - http://localhost:9091/grand/doctors

Inbound Endpoints¶

List inbound endpoints in an environment.
- Command
```
apictl mi get inbound-endpoints -e <environment>
```
  Info
  
  Flags:
  - Required :
    --environment or -e : Environment of the Micro Integrator to be searched
  - Optional :
    --format : pretty-print using templates
  Example
```
apictl mi get inbound-endpoints -e dev
```
- Response
```
NAME                 TYPE
httpInboundEP        http
```

Get information on a specific inbound endpoint in an environment.

Command
```
apictl mi get inbound-endpoints [inbound-name] -e <environment>
```
Info

Flags:
- Required :
  --environment or -e : Environment of the Micro Integrator to be searched
- Optional :
  --format : pretty-print using templates
Example
```
apictl mi get inbound-endpoints httpInboundEP -e dev
```

Response

Name - httpInboundEP
Type - http
Stats - enabled
Tracing - enabled
Parameters :
NAME                                   VALUE
inbound.http.port                      8697
inbound.worker.pool.size.core          400
inbound.worker.pool.size.max           500
inbound.worker.thread.keep.alive.sec   60
inbound.worker.pool.queue.length       -1
inbound.thread.id                      PassThroughInboundWorkerPool

Local Entries¶

List local entries in an environment.
- Command
```
apictl mi get local-entries -e <environment>
```
  Info
  
  Flags:
  - Required :
    --environment or -e : Environment of the Micro Integrator to be searched
  - Optional :
    --format : pretty-print using templates
  Example
```
apictl mi get local-entries -e dev
```
- Response
```
NAME                    TYPE
sample-local-entry      Inline Text
```
Get information on a specific local entry in an environment.
- Command
```
apictl mi get local-entries [local-entry-name] -e <environment>
```
  Info
  
  Flags:
  - Required :
    --environment or -e : Environment of the Micro Integrator to be searched
  - Optional :
    --format : pretty-print using templates
  Example
```
apictl mi get local-entries sample-local-entry -e dev
```
- Response
```
Name - sample-local-entry
Type - Inline Text
Value - 0, 1
```

Message Processors¶

List message processors in an environment.

Command
```
apictl mi get message-processors -e <environment>
```
Info

Flags:
- Required :
  --environment or -e : Environment of the Micro Integrator to be searched
- Optional :
  --format : pretty-print using templates
Example
```
apictl mi get message-processors -e dev
```

Response

NAME                      TYPE                                     STATUS
scheduled-msg-processor   Scheduled-message-forwarding-processor   active

Get information on a specific message processor in an environment.

Command

apictl mi get message-processors [message-processor-name] -e <environment>

Info

Flags:

Required :
--environment or -e : Environment of the Micro Integrator to be searched
Optional :
--format : pretty-print using templates

Example

apictl mi get message-processors scheduled-msg-processor -e dev

Response

Name - scheduled-msg-processor
Type - Scheduled-message-forwarding-processor
File Name - scheduled-msg-processor-1.0.0.xml
Message Store - in-memory-message-store
Artifact Container - [ Deployed From Artifact Container: HealthCareCompositeExporter ]
Status - active
Parameters :
 client.retry.interval = 1000
 interval = 1000
 is.active = true
 max.delivery.attempts = 4
 max.delivery.drop = Disabled
 max.store.connection.attempts = -1
 member.count = 1
 store.connection.retry.interval = 1000
 target.endpoint = PineValleyEndpoint
 throttle = false

Message Stores¶

List message stores in an environment.

Command
```
apictl mi get message-stores -e <environment>
```
Info

Flags:
- Required :
  --environment or -e : Environment of the Micro Integrator to be searched
- Optional :
  --format : pretty-print using templates
Example
```
apictl mi get message-stores -e dev
```

Response

NAME                      TYPE                      SIZE
in-memory-message-store   in-memory-message-store   0

Get information on a specific message store in an environment.

Command
```
apictl mi get message-stores [message-store-name] -e <environment>
```
Info

Flags:
- Required :
  --environment or -e : Environment of the Micro Integrator to be searched
- Optional :
  --format : pretty-print using templates
Example
```
apictl mi get message-stores in-memory-message-store -e dev
```

Response

Name - in-memory-message-store
File Name - in-memory-message-store-1.0.0.xml
Container - [ Deployed From Artifact Container: HealthCareCompositeExporter ]
Producer - org.apache.synapse.message.store.impl.memory.InMemoryProducer@3d288f9e
Consumer - org.apache.synapse.message.store.impl.memory.InMemoryConsumer@5e6443d6
Size - 0
Properties :
No Properties found

Proxy Services¶

List proxy services in an environment.

Command
```
apictl mi get proxy-services -e <environment>
```
Info

Flags:
- Required :
  --environment or -e : Environment of the Micro Integrator to be searched
- Optional :
  --format : pretty-print using templates
Example
```
apictl mi get proxy-services -e dev
```

Response

NAME                WSDL 1.1                                                WSDL 2.0
StockQuoteProxy     http://localhost:8290/services/StockQuoteProxy?wsdl     http://localhost:8290/services/StockQuoteProxy?wsdl2

Get information on a specific proxy service in an environment.

Command
```
apictl mi get proxy-services [proxy-name] -e <environment>
```
Info

Flags:
- Required :
  --environment or -e : Environment of the Micro Integrator to be searched
- Optional :
  --format : pretty-print using templates
Example
```
apictl mi get proxy-services StockQuoteProxy -e dev
```

Response

Name - StockQuoteProxy
WSDL 1.1 - http://localhost:8290/services/StockQuoteProxy?wsdl
WSDL 2.0 - http://localhost:8290/services/StockQuoteProxy?wsdl2
Stats - disabled
Tracing - disabled

Sequences¶

List sequences in an environment.

Command
```
apictl mi get sequences -e <environment>
```
Info

Flags:
- Required :
  --environment or -e : Environment of the Micro Integrator to be searched
- Optional :
  --format : pretty-print using templates
Example
```
apictl mi get sequences -e dev
```

Response

NAME                STATS               TRACING
fault               disabled            disabled
main                disabled            disabled
sample-sequence     disabled            disabled

Get information on a specific sequence in an environment.

Command
```
apictl mi get sequences [sequence-name] -e <environment>
```
Info

Flags:
- Required :
  --environment or -e : Environment of the Micro Integrator to be searched
- Optional :
  --format : pretty-print using templates
Example
```
apictl mi get sequences sample-sequence -e dev
```

Response

Name - sample-sequence
Container - [ Deployed From Artifact Container: HealthCareCompositeExporter ]
Stats - disabled
Tracing - disabled
Mediators - LogMediator, STRING

Scheduled Tasks¶

List scheduled tasks in an environment.
- Command
```
apictl mi get tasks -e <environment>
```
  Info
  
  Flags:
  - Required :
    --environment or -e : Environment of the Micro Integrator to be searched
  - Optional :
    --format : pretty-print using templates
  Example
```
apictl mi get tasks -e dev
```
- Response
```
NAME
sample-cron-task
CheckPriceTask
```
Get information on a specific scheduled task in an environment.
- Command
```
apictl mi get tasks [task-name] -e <environment>
```
  Info
  
  Flags:
  - Required :
    --environment or -e : Environment of the Micro Integrator to be searched
  - Optional :
    --format : pretty-print using templates
  Example
```
apictl mi get tasks sample-cron-task -e dev
```
- Response
```
Name - sample-cron-task
Trigger Type - cron
Cron Expression - 0 30 1 * * ?
```

Templates¶

List all templates in an environment.

Command
```
apictl mi get templates -e <environment>
```
Info

Flags:
- Required :
  --environment or -e : Environment of the Micro Integrator to be searched
- Optional :
  --format : pretty-print using templates
Example
```
apictl mi get templates -e dev
```

Response

NAME                  TYPE
sample_seq_template   Sequence
sample_template       Endpoint

List a specific type of template in an environment.
- Command
```
apictl mi get templates [template-type] -e <environment>
```
  Info
  
  Flags:
  - Required :
    --environment or -e : Environment of the Micro Integrator to be searched
  - Optional :
    --format : pretty-print using templates
  Example
```
apictl mi get templates endpoint -e dev
```
```
apictl mi get templates sequence -e dev
```
- Response
```
NAME
sample_seq_template
```
Get information on a specific template in an environment.
- Command
```
apictl mi get templates [template-type] [template-name] -e <environment>
```
  Info
  
  Flags:
  - Required :
    --environment or -e : Environment of the Micro Integrator to be searched
  - Optional :
    --format : pretty-print using templates
  Example
```
apictl mi get templates endpoint sample_template -e dev
```
- Response
```
Name - sample_template
Parameters : name, uri
```

Change status of an Artifact¶

You can use the commands below to activate or deactivate endpoints, message processors or proxy services deployed in a Micro Integrator.

Endpoint¶

Activate an endpoint deployed in a Micro Integrator.

Command

apictl mi activate endpoint [endpoint-name] -e <environment>

Info

Flags:

Required :
--environment or -e : Environment of the Micro Integrator to be searched

Example

apictl mi activate endpoint GrandOakEndpoint -e dev

Response
```
GrandOakEndpoint is switched On
```

Deactivate an endpoint deployed in a Micro Integrator.

Command

apictl mi deactivate endpoint [endpoint-name] -e <environment>

Info

Flags:

Required :
--environment or -e : Environment of the Micro Integrator to be searched

Example

apictl mi deactivate endpoint GrandOakEndpoint -e dev

Response
```
GrandOakEndpoint is switched Off
```

Message Processor¶

Activate a message processor deployed in a Micro Integrator.

Command

apictl mi activate message-processor [message-processor-name] -e <environment>

Info

Flags:

Required :
--environment or -e : Environment of the Micro Integrator to be searched

Example

apictl mi activate message-processor scheduled-msg-processor -e dev

Response
```
scheduled-msg-processor : is activated
```

Deactivate a message processor deployed in a Micro Integrator.

Command

apictl mi deactivate message-processor [message-processor-name] -e <environment>

Info

Flags:

Required :
--environment or -e : Environment of the Micro Integrator to be searched

Example

apictl mi deactivate message-processor scheduled-msg-processor -e dev

Response

scheduled-msg-processor : is deactivated

Proxy Service¶

Activate a proxy service deployed in a Micro Integrator.

Command

apictl mi activate proxy-service [proxy-name] -e <environment>

Info

Flags:

Required :
--environment or -e : Environment of the Micro Integrator to be searched

Example

apictl mi activate proxy-service StockQuoteProxy -e dev

Response

Proxy service StockQuoteProxy started successfully

Deactivate a proxy service deployed in a Micro Integrator.

Command

apictl mi deactivate proxy-service [proxy-name] -e <environment>

Info

Flags:

Required :
--environment or -e : Environment of the Micro Integrator to be searched

Example

apictl mi deactivate proxy-service StockQuoteProxy -e dev

Response

Proxy service StockQuoteProxy stopped successfully

Manage Loggers used in Micro Integrator¶

Get information on a specific logger¶

Command
```
apictl mi get log-levels [logger-name] -e <environment>
```
Info

Flags:
- Required :
  --environment or -e : Environment of the Micro Integrator to be searched
- Optional :
  --format : pretty-print using templates
Example
```
apictl mi get log-levels org-apache-coyote -e dev
```

Response

NAME                    LOG LEVEL           COMPONENT
org-apache-coyote       WARN                org.apache.coyote

Add a new logger¶

You can use the command below to add a new logger to a Micro Integrator.

Command

apictl mi add log-level [logger-name] [class-name] [log-level] -e <environment>

Info

Flags:

Required :
--environment or -e : Environment of the Micro Integrator to be searched

Example

apictl mi add log-level synapse-api org.apache.synapse.rest.API DEBUG -e dev

Response

Successfully added logger for ('synapse-api') with level DEBUG for class org.apache.synapse.rest.API

Update a logger¶

You can use the command below to update the log level of an existing logger.

Command

apictl mi update log-level [logger-name] [log-level] -e <environment>

Info

Flags:

Required :
--environment or -e : Environment of the Micro Integrator to be searched

Example

apictl mi update log-level org-apache-coyote DEBUG -e dev

Response

Successfully added logger for ('org-apache-coyote') with level DEBUG

Download log files¶

List available log files¶

Command
```
apictl mi get logs -e <environment>
```
Info

Flags:
- Required :
  --environment or -e : Environment of the Micro Integrator to be searched
- Optional :
  --format : pretty-print using templates
Example
```
apictl mi get logs -e dev
```

Response

NAME                            SIZE
wso2carbon.log                  429.5 KB
correlation.log                 0 B
wso2carbon-trace-messages.log   0 B
wso2-mi-api.log                 11.9 KB
patches.log                     15.7 KB
audit.log                       0 B
wso2-mi-service.log             10.3 KB
http_access_.log                35.8 KB
wso2error.log                   156.2 KB

Download a specific log file¶

Command
```
apictl mi get logs [file-name] -p [download-location] -e <environment>
```
Info

Flags:
- Required :
  --environment or -e : Environment of the Micro Integrator to be searched
- Optional :
  --path or -p : Path the file should be downloaded (default is current executable directory)
Example
```
apictl mi get logs wso2carbon.log -p log-files -e dev
```

Response

Log file downloaded to log-files/wso2carbon.log

Monitor transactions¶

Transaction Counts¶

You can use the command below to get information about the inbound transactions received by the Micro Integrator.

Command

apictl mi get transaction-counts -e <environment>

apictl mi get transaction-counts [year] [month] -e <environment>

Info

Flags:

Required :
--environment or -e : Environment of the Micro Integrator to be searched
Optional :
--format : pretty-print using templates

Example

apictl mi get transaction-counts -e dev

apictl mi get transaction-counts 2021 01 -e dev

Response

YEAR        MONTH       TRANSACTION COUNT
2021        1           126

Transaction Reports¶

You can use the command below to generate the transaction count summary report based on the inbound transactions received by the Micro Integrator.

Command

apictl mi get transaction-reports [start] [end] -e <environment>

Info

Flags:

Required :
--environment or -e : Environment of the Micro Integrator to be searched
Optional :
--path or -p : Path the file should be downloaded (default is current executable directory)

Example

apictl mi get transaction-reports 2020-05 2020-06 -e dev

apictl mi get transaction-reports 2020-05 -e dev -p reports/mi

Response

Transaction Count Report created in reports/mi/transaction-count-summary-1610597725520763836.csv

Update HashiCorp AppRole Pull secret ID¶

You can use the command below to update the HashiCorp AppRole Pull secret ID that is used by the Micro Integrator to connect with HashiCorp.

Note

The HashiCorp secret ID is only applicable when AppRole Pull authentication is used between the Micro Integrator and HashiCorp.
This command only updates the SecretId for the current session of the Micro Integrator. To persist the Secret Id, you need to update the deployment.toml file and restart the Micro Integrator.

See Using HashiCorp Secrets for details.

Command

apictl mi update hashicorp-secret [secret_id] -e <environment>

Info

Flags:

Required :
--environment or -e : Environment of the Micro Integrator for which the HashiCorp secret ID should be updated.

Example

apictl mi update hashicorp-secret 47c39b09-c0a9-6ebf-196e-038eb7aad336 -e dev

Response

SecretId value is updated in HashiCorp vault runtime configurations. To persist the new SecretId in the next server startup, please update the deployment.toml file

Managing Integrations with apictl¶

Login to a Micro Integrator¶

Logout from a Micro Integrator¶

Manage Users¶

Get information about users¶

Add a new user¶

Delete a user¶

Manage Roles¶

Get information about roles¶

Add a new role¶

Delete a role¶

Assign/revoke roles to/from users¶

Monitor Integration Artifacts¶

Composite Applications (CApps)¶

Integration APIs¶

Connectors¶

Data Services¶

Endpoints¶

Inbound Endpoints¶

Local Entries¶

Message Processors¶

Message Stores¶

Proxy Services¶

Sequences¶

Scheduled Tasks¶

Templates¶

Change status of an Artifact¶

Endpoint¶

Message Processor¶

Proxy Service¶

Manage Loggers used in Micro Integrator¶

Get information on a specific logger¶

Add a new logger¶

Update a logger¶

Download log files¶

List available log files¶

Download a specific log file¶

Monitor transactions¶

Transaction Counts¶

Transaction Reports¶

Update HashiCorp AppRole Pull secret ID¶